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SUMMARY OF AMENDMENTS 



Operator Commands 



The following operator commands have been modified to 
include support for the IBM Series/1 4 9 6 9 Magnetic Tape 
Subsystem ' 

• $C 
SVARYOFF 

• SVARYON 



The $ V E R I F Y utility has been added for the Indexed Access Meth 
od Version 1 Modification Level 2. 



Session Manager 



The following changes have been made to the Session Man- 
ager for the Event Driven Executive Version 2 
(5719-UT4) : 

• $PL/I (Option 10) has been added to the Program 
Preparation secondary option menu to support the 
PL/I comp i ler . 

• Option 3 "Disk Utilities" of the primary option menu 
has been changed to "Data Management". 

• STAPEUT1 (Option 10) has been added to the "Data 
Management" secondary option menu to support tape 
management . 



$TAPEUT1 Utility 



This new utility is described in Chapter 4. The tape 
READ/WRITE return codes are described in Chapter 6. 
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SPREFIND Uti litv 



This utility has been updated to include support for 
locating tape data sets. 



$JOBUTIL - Job Stream Processor 



This utility has been updated to support the PL/I 
comp i ler . 



Suggested Utility Function Table 



This table has been expanded to include all the utility 
programs within this book for easy reference to their 
functions and commands. 



Glossary 



New terms have been added to the glossary 



Reorgan i zat i on 



The book has been reorganized. It is now divided into 
six chapters with an introduction for each chapter. 

Chapter 4 presents the utilities in alphabetic order. 
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Overvi eu 



Most utility programs are used interactively from a terminal. 
After a utility program is invoked* you can list its defined 
operations and command by entering a question mark in response 
to the 'COMMAND (?):' prompt. 

In Chapter 4 » the utility programs are presented in alphabetic 
order along with examples of their usage. 

The session manager groups the utility programs by function. 
The following represents the functional groupings of the util- 
ities along with the operations they perform. 



Text Editing Utilities 

The text editing utilities provide facilities for entering and 
editing source programs as follows? 

SEDITl A line editor that uses host data sets 

$EDIT1N A line editor that uses Series/1 data sets 

$FSEDIT A full screen editor that uses Series/1 or host data 
sets 



Program Preparation Utilities 

The program preparation utilities aid in: 

$COBOL Compiling COBOL programs 

$EDXASM Compiling Event Driven Language programs 

$EDXLIST Reformatting $EDXASM listings 

$FORT Compiling FORTRAN programs 

SLINK Link editing more that one program together 

$PL/I Compiling PL/I programs 

$PREFIND Prefinding data sets and overlay programs to shorten 
program loading time 

$S1ASM Assembling Series/1 assembler language programs 
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Overvi ew 



$UPDATE Converting an object program into an executable load 
modu le 

$UPDATEH Converting a host object program into an executable 
load module 



^., 



Da ta Management Utilities 

The data management utilities aid in: 

SCOMPRES Compressing disk or diskette libraries 

$COPY Copying disk or diskette data sets or volumes 

$C0PYUT1 Copying data sets and volumes with dynamic 
allocation of the receiving data sets 

$DASDI Initializing, formatting, and verifying disks or 
d i sket tes 

SDISKUTl Allocating and deleting data sets; listing directory 
data 

SDISKUT2 Patching and dumping data sets; listing the error 
log data set 

SDISKUT3 Performing data management functions from another 
program. $DISKUT3 is described in the System Guide . 

$IAMUT1 Building and maintaining Indexed Access Method data 
sets 






$INITDSK Initializing and verifying a direct access storage 
volume for use with the Event Driven Executive 

$MOVEVOL Transferring volumes of data between systems and 
creating backup copies of an online data base 

$PDS Organizing and accessing partitioned data sets from 
another program. $PDS is described in the System 
Guide . 

$TAPEUT1 Allocating tape data sets, copying data sets or vol- 
umes from disk or diskette to tape, from tape to disk 
or diskette, or from tape to tape, and changing tape 
attr i butes . 

SVERIFY Verifying and displaying information about indexed 
data sets 



J 
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Overvi eu 



MESSAGES AND CODES 



While using the Event Driven Executive* you may encounter 
return codes, completion codes, and messages. They are found in 
Chapter 6. Messages and Codes. 



HARDCOPY FUNCTION FOR THE 4978/4979 DISPLAY 



Pressing the PF6 key or the assigned hard-copy key on the 4978 
or 4979 keyboard causes the entire display (24 lines) to be 
transferred to the designated hard-copy device. (During sys- 
tem generation, the TERMINAL statement is used to define the 
hard-copy device.) If the hard-copy device has not been 
defined or is currently busy with another operation, then no 
action is taken. Otherwise, the screen cursor moves to each 
line as it is printed, returning to its original position after 
the page is printed. The hard-copy function should not be 
activated while the screen is being changed or when I/O is 
being directed to the screen. Also, while the hard-copy func- 
tion is in progress, keys (such as the attention key, PF keys, 
or ENTER) should not be pressed. Simultaneous operation of I/O 
and the hard-copy function can result in unpredictable 
results. 



Chapter 1. Overview 



Operator Commands 
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Operator Commands 



$L - Load Program 

The $ L command loads a program from disk or diskette and starts 
it. 

Syntax 



$L program > vo lume > storage data set(s) 

Required: program 

Default: volume defaults to IPL volume; storage 
defaults to the amount specified on the 
PROGRAM statement of the program to be 
loaded 



Operands Description 

program The name of the program being loaded 

volume The name of the volume where the program being 
loaded i s stored 

storage The total additional storage (in bytes) to be 
added to the end of the loaded program (overrides 
the STORAGE= parameter specified in the PROGRAM 
statement ) 

data set(s) Data set(s) to be passed to the program being 
loaded (if specified in PROGRAM statement); speci- 
fy the data set(s) in the order the program 
expects . 

$ L Example 

Load a program and pass a single data set : 



> $L 



PROCESS, EDX003 MYDATA 



This example shows the command and parameters entered in single 
line format. It is good practice to enter as much of the 
required information as possible on the same line of input as 
the $L command to minimize the time the loader is busy. 
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Note: Wait until the system is initialized before loading a 

program. If your system has timers, the system is initial- / ) 

ized when the 'SET TIME AND DATE USING $T f appears (or when V> 

the time and date are printed). If your system does not have 

timers, the system is initialized when it enters the wait 

state after the storage map has been displayed. 



x. y 
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Operator Commands 



$P - Patch Storage 



x.^ 



Allows main storage to be patched online. Enter the patch data 
in response to prompting messages. 

Syntax 



$ P origin, address, count 

Required: or i g i n , address , count 
Default: None 



Operands Descr i pt i on 

origin The hexadecimal origin address (program load 
point) . 



address 



count 



The hexadecimal address in the program at which the 
patch i s to start . 

The decimal number of words to patch. 






Example - Patch word XMOO' of program loaded at to X'FFFF' 



> $p 




ENTER ORIGIN: 0000 




ENTER ADDRESS, COUNT: 


0100,1 


0100: C462 




DATA: FFFF 




ANOTHER PATCH? N 





y 
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Operator Commands 



$T - Set Date and Time 



Enters a new date and time into the system and resets the 
realtime clock. You can only use $T from terminals having the 
label $SYSLOG and $SYSL0GA. After entering the time, the timer 
is started at the instant carriage return/ENTER is pressed. 
This resets the seconds to zero. 

Notes : 

1. Make sure your time and date entry is correct as the system 
does not verify this data. 

2. If $T is entered from other than $SYSLOG or $SYSLOGA, it is 
equivalent to entering $W. 

Syntax 






$T 

Requ i red : 

Default : 



date 1 1 i me 
da te f t i me 
date defaults 
time defaults 



to 
to 



00/00/00 
00:00:00 



Operands Description 
date The current date 
time The current time 

Example - Set date and time 



> $T 

DATE(M.D.Y): 8:22:79 
TIME(H.M): 11:15 



Chapter 2. The Operator Commands 
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SVARYOFF - Set Device Offline 



Sets the status of a disk* diskette* diskette magazine unit* or 
tape drive to offline. 

On the 4966 diskette magazine unit* each diskette volume in 
individual diskette slots or either of the diskette magazines 
can be set to offline. 

When you vary a tape device offline, that tape drive is rewound 
to the load point and set logically offline. 

Syntax 



SVARYOFF 
Requ i r ed : 
Default: 



i oda slot 
i oda 
None 



Operands Description 

ioda The hexadecimal device address of the device to be 
varied offline. 

slot The slot number of the diskette to be varied 
off-line; this parameter applies to the 4966 only. 
The valid slot numbers for the 4966 magazine unit 
are : 




1 
2 
3 
A 
B 



All diskettes (1, 2, 3, A, B) 

Slot 1 

Slot 2 

Slot 3 

Magazine 1 

Magaz i ne 2 
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Examp les t 

Vary offline the volume in slot 2 of a 4966 device at address 2 2 



> $VARYOFF 22 2 

IBMIRD OFFLINE 
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Operator Commands 



SVARYON ioda slot|file f EX' 

Required: ioda 

Default: file defaults to 1 > maximum value of 255 



Note : The OR symbol (J) indicates mutually exclusive operands. 



Operands Description 

ioda The hexadecimal device address of the device to be 
varied online. 






slot 



The slot number of the diskette to be varied online; 
this parameter applies to the 4966 only. The valid 
slot numbers for the 4966 magazine unit are: 



All diskettes (1, 2, 3 , A, B) 
Slot 1 
Slot 2 



Slot 3 



file 



EX 



B 



Magazine 1 



Magazine 2 



The decimal file number on the tape to be accessed. 
This parameter applies to the tape drive only. 

This parameter applies to tape only and requests an 
expiration date override. If a tape data set is ini- 
tialized with an expiration date* this parameter 
must be used to write to that tape data set and the 
file number must be specified. 
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Operator Commands 



Examples » 

Vary diskette in slot 1 of 4966 at device address 2 2 online 



> $VARYON 22 1 

IBMIRD ONLINE 



Vary a standard label (SL) tape (volume 123456) at address 4 C 
online and access the first file. 



> $VARYON 4C 

123456 ONLINE 



Vary a non-labeled (NL) tape at address 4 C online and access 
the second file, where TAPE1 was the ID assigned at system gen- 
eration. 



^_y 



> $VARYON 4C 2 

TAPE1 ONLINE 



Vary a standard label tape at address 4 D online. The first fill 
of this tape has an expiration date that has not expired; how 



ever, output to this file is allowed. 



> $VARYON 4D 1 EX 

OVERRIDE EXPIRATION DATE CHECK? 
123456 ONLINE 



(Y,N) 



c 



y 
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$COPY 



$COPY - COPY DATA SET 



$ C P Y copies a disk or diskette data set, in part or its entire- 
ty, to another disk or diskette data set. 

When copying library members, the target member must already 
exist (allocate using SDISKUT1), and must be of the same organ- 
ization as the source member. Two organization types are 
a va i lab le : 

DATA Data sets used as work files, user source modules, and 
application data set 

PROGRAM Data sets that will contain executable (loadable) 
Event Driven Executive programs 

When copying program members, the size of the target member 
must be equal to or greater than the source member. When copy- 
ing data members, an entire member may be copied, or only a 
selected number of records (partial copy) may be copied. If 
the entire member is to be copied, the target data member must 
be equal to or larger than the source. If you are doing a par- 
tial copy, the target member need not be as large as the source 
but must have enough space following the starting target record 
number to accommodate the number of records being copied from 
the source member. 

When copying diskette volumes to disk, the target data set must 
be of equal or greater size than the diskette size in records. 
When copying a disk volume to another disk volume, both volumes 
should be equal in size. If the source volume is larger than 
the target, you are prompted for the name of the source data set 
you wish copied to the target. If the source volume is smaller 
than the target, you are prompted for the name of the target 
data set into which the source volume will be copied. 



Chapter 4. The Utilities 
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$COPY 



Invoki ng $COPY 

$COPY is invoked by the $L command or primary option 3 of the 
session manager. 



$COPY Commands 

The commands available^ under $COPY are listed below. To dis- 
play this list at your terminal, enter a question mark in 
respond to the prompting message COMMAND (?):. 



COMMAND (?): ? 

CD - COPY DATA SET 

CV - COPY VOLUME 

RE - COPY FROM BASIC EXCHANGE 

WE - COPY TO BASIC EXCHANGE 

(-CA- WILL CANCEL) 
EN - END PROGRAM 
COMMAND (?): 






After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example, CD ) . 



Absolute Record Copy 

$COPY provides an absolute record capability, using the spe- 
cial system names $$EDXLIB and $$EDXVOL. This allows you to 
copy a record relative to the beginning of a volume ($$EDXVOL) 
or relative to the beginning of a library ($$EDXLIB). This 
capability can be used when copying one diskette volume to 
another. The CV command of $COPY does not copy the first cylin- 
der on diskette. If the source diskette is an IPL volume (has 
IPL text and $EDXNUC), the IPL text, contained in the first 
record of the first cylinder, is not copied to the target 
diskette. Therefore, the target diskette volume, although 
containing a supervisor in SEDXNUC, is not able to load that 
supervisor when the IPL key is pressed. 



To copy the IPL text to the target diskette, use the CD command 
of $COPY; specify $$EDXVOL as the data set name, and record 1 as 
the first and last record to be copied. 



o 
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$COPY 



See the data set naming conventions in the & s y s . for a 
description of the special data set names* $$EDXVOL and 
$$EDXLIB, which are used when doing absolute record and basic 
exchange copying. 



CD - Copy Data Set 

The CD command is used to copy disk or diskette data sets to a 
preallocated disk or diskette target data set. When copying 
data sets, an entire data set may be copied or only a select 
number of records (partial copy) may be copied. If the entire 
data set is to be copied, the target .data set must be equal to 
or larger than the source. If you do a partial copy, the target 
data set need not be as large as the source, but should have 
enough space following the starting record number to accommo- 
date the number of records being copied from the source data 
set. 






CD Examples 

Copy Entire Data Set t 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) : DATAFIL1 

COPY ENTIRE DATA SET? Y 

TARGET (NAME, VOLUME) : DATAFIL2> EDX002 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

50 RECORDS COPIED 

COMMAND (?): 



Notes : 

1. Data sets allocated as program organization may not be 
copied to a data set allocated as data organization. 

2. When copying program members, the target and source data 
sets must be equal in size. 
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SCOPY 



r~ 



Partial Copy of a Data Set 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) : DATAFIL1 

COPY ENTIRE DATA SET? N 

FIRST RECORD: 1 

LAST RECORD: 3 

TARGET (NAME, VOLUME) : DATAFIL2 

FIRST RECORD: 1 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

3 RECORDS COPIED 

COMMAND (?): 



If the target data set is too small to accommodate the amount of 
data to be copied from the source data set, the following mes- 
sage is issued: 



*** TARGET DATA SET TOO SMALL *** 
*** COPY REQUEST CANCELLED *** 






When the output data set is on disk or diskette, the end of data 
pointers are updated. 
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$COPY 



CV - Copy Volume 



The CV command allows you to copy entire volumes* providing a 
volume backup capability. A disk volume may be copied to 
another disk volume* a diskette volume to another diskette vol- 
ume* or a diskette volume to a preallocated disk data set of 
appropriate size in records* as follows? 



Type 



Number of Records 
at 128 Bytes/Sector 



Di skette 
Diskette 



949 
1924 



Volume copy operations do not add the members in a source vol- 
ume to the target volume* the original contents of the target 
volume are replaced, including the directory. 

If you have two or more 4964 Diskette units* or a 4964 and a 
4966 Diskette Magazine unit, diskette volume copies between 
diskette devices are possible. If you have a single diskette 
drive and a disk, diskette volume copies can be performed using 
the following procedure: 

1. Allocate a target data set on disk of appropriate size. 

2. Using the CV command* copy the diskette volume to the disk 
data set , 

3. Mount the target diskette on the diskette device and vary 
online. 

4. Using the CV command, copy the contents of the disk data 
set to the target diskette. 

If you have a single 4966 Diskette Magazine Unit and a disk, the 
above procedure is also recommended. 
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CV Example 

Copy a Diskette to a backup data set on a 4962 disk 






COMMAND (?): CV 

COPY VOLUME 

ENTER SOURCE VOLUME: IBMEDX 
ENTER TARGET VOLUME: EDX002 
ENTER TARGET DATA SET NAME: DATA1 
ARE ALL PARAMETERS CORRECT? Y 
COPY COMPLETE 

949 RECORDS COPIED 

COMMAND (?): 



The CV command copies the entire diskette volume. Therefore, 
the target data set should be of equal or greater size than the 
diskette size in records. If the target data set is not large 
enough* you may choose to do a partial copy or allocate (using 
SDISKUT1) a target data set large enough to accommodate the 
source . 

If the target data set is not large enough, you are prompted as 
f ol lows : 






V 



SOURCE DATA SET HAS nn RECORDS 

TARGET VOLUME HAS ONLY nn 

DO YOU WISH TO CONTINUE? (Y/N) 



If you respond Y , the source is copied to the target data set 
until the target is full. If you respond N, the CV command ends 
and you are prompted for another command, COMMANDC?):. 

Note: Once you have copied a volume to a target disk volume, 
the original contents of the target volume are replaced, 
including the directory. As a result, the original contents 
of the target disk volume are no longer accessible. 

Note: See the System Gu i de for an explanation of disk and 
diskette organization. 
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$COPYUTX 



RE - Copy from Basic Exchange 

The RE command copies a basic exchange data set from a diskette 
to a disk data set. A basic exchange data set is contained on a 
diskette that was formatted for the Standard for Information 
Interchange. Only one-sided* 128-byte diskettes can be used 
because EDX recognizes only one volume on a diskette. The tar- 
get disk data set must be allocated using $DISKUT1 before using 
the RE command . 

You are prompted for the source diskette data set name and vol- 
ume, the target disk data set name and volume, the number of the 
first record to be written to the target data set, and the basic 
exchange data set name. 



RE Example 

Copy Entire Basic Exchange Diskette Data Set to Disk ? 



COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME) : $$EDXVOL, IBMEDX 
TARGET (NAME, VOLUME) : DATAFIL1, EDX002 

SPECIFY START/END? (Y/N): N 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
NUMBER OF RECORDS COPIED: 52 
COPY COMPLETED 

COMMAND (?): 
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SCOPYUTl 






Copy Basic Exchange Data Set to Disk : In this example* the 



record number where the copy 
i f i e d . 



is to start on target disk is spec 



COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME) : $$EDXVOL> IBMEDX 
TARGET (NAME, VOLUME) : DATAFIL1 , EDX002 

SPECIFY START/END? Y/N : Y 
FIRST RECORD: 10 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
NUMBER OF RECORDS COPIED: 151 
COPY COMPLETED 

COMMAND (?): 



WE - Copy to Basic Exchange 

The WE command copies a disk data set to a basic exchange data 
set on diskette. The diskette data set must be allocated 
before using NE. Use $DASDI to format the diskette for Stand- 
ard for Information Interchange. Under this format, $DASDI 
formats a volume called I B M E D X , initializes the basic exchange 
header on the diskette, and automatically allocates a data set 
named DATA. DATA consists of all the data tracks on the 
d i skette . 

You are prompted for the source disk data set name and volume, 
the starting or ending records, the target diskette data set 
name and volume, and the basic exchange data set name. 



^O 7 ' 
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WE Example 

Copy a Disk Data Set to a Basic Exchange Diskette : 



SCOPYUTl 



COMMAND (?): WE 

SOURCE (NAME, VOLUME) : DATAFIL1 , EDX002 

SPECIFY START/END? (Y/N): N 

TARGET ($$EDXV0L, VOLUME) : $$EDXVOL, IBMEDX 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
COPY COMPLETE 

COMMAND (?): 



Copy a Disk Data Set to a Basic Exchange Diskette : In this 
example, the beginning and ending records numbers on disk to be 
copied to the target diskette are specified. 



COMMAND (?): WE 

SOURCE (NAME, VOLUME) : DATAFIL1, EDX002 

SPECIFY START/END? (Y/N): Y 

FIRST RECORD: 100 

LAST RECORD: 150 

TARGET ($$EDXVOL, VOLUME) : $$EDXVOL, IBMEDX 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
COPY COMPLETE 

COMMAND (?): 



Notes: 

1. Errors may occur if the diskette contains uninitialized 
HDRls. Data on the diskette is read and written two sec- 
tors per I/O operation. 

2. The diskette data set accessed must start on an odd sector 
boundary . 
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$DASDI 



$DASDI - FORMAT DISK OR DISKETTE 






$ D A S D I initializes your 4962 or 4963 disk or formats diskettes 
on the 496 4 or 4966 diskette units. The utility can be used 
online. When this utility is invoked, you are prompted for one 
of the following disk or diskette initialization options : 

• Option 1 - 4964, 4966 diskette initialization. 

• Option 2 - 4962 disk initialization 

• Option 3 - 4963 disk initialization 

$ D A S D I may be loaded into any partition, but $ D A S D I will load 
initialization routines into part ion 1. ($IDSKETT, $14962, 
$14965) into partition 1 . An error message will be returned if 
partition 1 does not have space for initialization routines. 

Caut i on : For disk initialization, a program that accesses the 
disk being initialized should not be run concurrently with this 
utility. 

Diskette initialization can run concurrently with other pro- 
grams . 



%y 



Invoking $DASDI 

$DASDI is invoked by the $L command or primary option 3 of the 
session manager . 

When $DASDI is invoked, you are prompted for one of the follow- 
ing initialization options: 

• Option - Stand-Alone Dump 4964/4966 Diskette Initializa- 
tion 

• Option 1 - 4964, 4966 Diskette Initialization 

• Option 2 - 4962 Disk Initialization 

• Option 3 - 4963 Disk Initialization 
Notes : 

1. $DASDI must be loaded in partition 1. 

2. When options 2 and 3 are executing, do not run a program 
that accesses the disk being initialized. 
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3. 



Di skette 
programs 



initialization can run concurrently with other 



Option - Create a Stand-Alone Dump Diskette 4964/4966 

Option uses a 4964 or 4966 diskette unit to initialize a 
2-sided single density 128 -byte diskette to be used for 
stand-alone dumps. $DASDI loads a program that places IPL text 
and the stand-alone dump utility on the front of the diskette. 
Once the diskette is created* it is ready for use. 

This diskette is reusable and does not have to be reformatted 
or recreated after it has been used to take a stand-alone dump. 



Option Example 

Create a Stand-Alone Dump Diskette on a 4966 : 



> $L $DASDI 

$DASDI 



15P, 00:28:55, LP= 7E00 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP DISKETTE 4964/4966 

1 = 4964, 4966 DISKETTE INITIALIZATION 

2 = 4962 DISK INITIALIZATION 

3 = 4963 DISK INITIALIZATION 

4 = EXIT DISK INITIALIZATION 
ENTER DISK INITIALIZATION OPTION: 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

* DISKETTE FORMATTING PROGRAM * 

* IF FORMATTING IS IN PROGRESS, DO NOT * 

* CANCEL ($C) THIS PROGRAM. INSTEAD, * 

* ENTER ATTN/$DASDI TO FORCE TERMINATION. * 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

ENTER DISKETTE ADDRESS IN HEX: 22 



FORMATTING 
IN SLOT 1. 



** WARNING ** 
WILL DESTROY ALL 
CONTINUE? Y 



DATA ON THE DISKETTE 



IBMEDX VARIED ONLINE 
FORMATTING COMPLETE 
STAND-ALONE DUMP DISKETTE 
ANOTHER DISKETTE? N 
DASDI ENDED AT 00:32:12 



CREATED 
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Option 1 - 4964, 4966 Diskette Initialization 



^r^ x 



Diskette Formats 

The $DASDI utility reformats single and double-sided 
diskettes. Three formats are available: 

1. Format for use with the Series/1 Event Driven Executive 

2 . Format to the IBM Standard for Information Interchange 

3, Format entire diskette to 128, 256, or 512 byte records. 

If you select the Event Driven Executive format, all tracks are 
formatted for 128 byte sectors. Also, cylinder is formatted 
according to the IBM Standard for Information Interchange. The 
assigned volume label is IBMEDX. 

Note : Use this format if all cylinders are to be formatted to 
128-byte sectors. 

If you initialize according to the IBM Standard for Information 
Interchange, Cylinder is formatted for 128-byte sectors, and 
the remaining cylinders are formatted for either 128-, 256-, or /f "\ 



C 
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$DASDI 



Restoring a Previously Assigned Alternate Sector 



ENTER OPTION: 2 

ENTER CCCHHSS OF SECTOR TO BE 
RESTORED OR END: 0010207 

0010207 HAS BEEN RESTORED FROM ccchhss 

ENTER CCCHHSS OF SECTOR TO BE 
RESTORED OR END: END 

ENTER OPTION: 4 

DISK INITIALIZATION ENDED 

$DASDI ENDED AT 01:01:27 



Note: The fixed head area on the 4963 is always referred to 
as Cylinder 511. This cylinder contains eight heads (16 
through 23) and 64 sectors (zero through 63). 
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$DEBUG - DEBUGGING TOOL 






SDEBUG is a tool for locating errors in programs. By operating 
a program under control of $ D E B U G , you can: 

• Stop the program each time execution reaches any of one or 
more instruction addresses that you have specified. These 
addresses are known as breakpoints. 

• List the contents of specified storage locations or regis- 
ter contents each time the program execution reaches one or 
more of your breakpoints. 

• Trace the flow of execution of instructions within the pro- 
gram by specifying one or more ranges of instruction 
addresses (known as trace ranges). Each time the program 
executes an instruction within any of the specified trace 
ranges* the terminal displays a message identifying the 
task name and the instruction address just executed. 
Optionally, program execution can be stopped after each 
instruction is executed within a trace range. Also, 
optionally, storage locations or register contents can be 
displayed on the terminal after the execution of each 
instruction within a trace range. 

• Restart program execution at the breakpoint or trace range 
address where it is currently stopped. Or, in the case of 
Event Driven Language instructions, restart program exe- 
cution at other than the next instruction. 



\y 



• List additional registers and storage location contents 
while the program is stopped at a breakpoint or at an 
instruction within a trace range. 

• Patch the contents of storage locations and registers. 

Using these functions, you can determine the results of compu- 
tations performed by the program and the sequence of 
instruction execution within the program. You can also modify 
data or instructions of the program during execution. 

To use $DEBUG effectively, you must have a printed listing of 
the program to be debugged which shows the storage addresses of 
each instruction and data area of interest. To obtain such a 
listing, specify PRINT GEN in the source program, after the 
PROGRAM statement, at assembly time. A PRINT NOGEN should pre- 
cede the PROGRAM statement to prevent the unnecessary printing 
of many system EQU statements, etc. For $EDXASM a satisfactory 
listing is produced by specifying LIST. 



o 
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Debug Usage Considerations 



The program debug facility aids in testing multitasked 
programs in a multiprogramming and multiuser environment. All 
of your interactions are via terminals and do not require the 
use of the machine console. A summary of the major features of 
the $DEBUG program follows: 



Notes • 
1. 



If the program being debugged is ended, $DEBUG must b e 
ended . 



$ D E B U G should be invoked from a terminal other than the one 
used by the program to be tested if the program uses 
4978/4979 terminals in STATIC screen mode. 






3. Multiple breakpoints and trace ranges can be established. 

4 . Several users can each use separate copies of $ D E B U G con- 
currently, if sufficient storage is available. 

5. Series/1 assembler language as well as Event Driven Lan- 
guage instructions can be traced and tested. 

6. Both supervisor and application programs can be debugged. 

7. Task names are automatically obtained from the program to 
be tested . 



8. Task registers #1 and #2 can be displayed and modified. 

9. Hardware registers RO through R7 and the IAR can be dis- 
played and modified. 

10. The task return code words can be displayed and modified. 

11. Five different data formats are accepted by the list and 
patch functions. 

12. No special preprocessing of a program is required to permit 
it to be debugged. 

13. All address specifications are made as shown in the program 
assembly listing without concern for * the actual memory 
addresses where the program is loaded into storage for 
testing. 

14. No processing overhead is incurred unless the hardware 
trace feature is enabled. Even then, the hardware trace 
feature is only enabled for specific tasks. 
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15. The debug facility can be activated for a program that is 
experiencing problems but was previously loaded without 
the debug facility. 

16. A program can be debugged by loading $DEBUG from a terminal 
other than the one from which the program to be tested was 
loaded . 

17. Breakpoints or trace ranges specified during a debug ses- 
sion can be 1 i sted . 

18. $DEBUG can control the execution of programs containing up 
to 20 tasks . 

The $ DEBUG program can be used to test different types of 
programs. The most common usage is to debug application 
programs written using the Event Driven Language instruction 
set. However^ it can also be used to test portions of applica- 
tion programs that are written in assembler language and 
portions of the supervisor program that are written in either 
Event Driven Language or Series/1 assembler language. Testing 
of the supervisor should normally be required only if you are 
making your own modifications or additions to this program. 

You can use $DEBUG to debug overlay programs by loading the 
primary program that will subsequently load the overlay pro- 
gram to be debugged. Load $ D E B U G after the overlay program is 
in storage. (For more information on debugging overlay pro- 
grams that are part of the Event Driven Language compiler* 
$ E D X A S M , refer to the Internal Design ). To suspend execution of 
the overlay program so that $ D E B U G can be loaded, enter a 
READTEXT or QUESTION as the first instruction of the overlay 
program. Multiple Terminal Manager users should code a CALL 
ACTION instruction to provide the required function. When the 
overlay program is entered, it pauses at the first instruction 
and waits for input. At this point, load $ D E B U G . This can be 
done from another terminal assigned to the same partition. 
Specify the overlay program name when prompted for the program 
name and indicate that no new copy of the overlay program is to 
be loaded . 

The $DEBUG utility can then be used to set breakpoints and 
perform other functions as required. If the overlay program 
causes a program check, it is cancelled by the system. If an 
overlay program terminates through a PROGSTOP or for any other 
reason and is reloaded by the primary program, any breakpoints 
or patches made prior to the termination are lost. 



f 



~x 
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Use of certain capabilities of $DEBUG requires a thorough know- 
ledge of both the supervisor and debugging techniques. For 
example, altering the contents of storage locations occupied 
by the supervisor or contents of the Series/1 hardware regis- 
ters could have undesirable effects on the operation of the 
supervisor or application programs in operation concurrently 
with $DEBUG. 



Note : Only those instructions that execute as part of a task 
can be debugged. Those portions of the supervisor program that 
service interrupts created by various hardware devices (disk* 
timers, terminals, etc) cannot be executed under control of 
SDEBUG. 



Start and Termination Procedure 



The primary method for activating the debug facility is to load 
$DEBUG and then specify the name of the program to be tested, 
when prompted (DBUGDEMO in the following example). $DEBUG then 
loads your program, inserts a breakpoint at the first executa- 
ble instruction, and notifies you that your program is stopped 
at this point. For example: 



> $L $DEBUG 

$DEBUG 26P,09: 10: 17, LP=5200 

PROGRAM NAME: DBUGDEMO 

DBUGDEMO 4P, 09:10:28, LP = 6700 

DBUGDEMO STOPPED AT 009E 
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SDEBUG Commands 



The following commands are available 



AT 


- Set break 


BP 


- List brea 




thus far 


END 


- Terminate 


GO 


- Act i vate 


GOTO 


- Change ex 


HELP 


- List debu 


LIST 


- Display s 


OFF 


- Remove br 


PATCH 


- Mod i f y st 


POST 


- Post an e 


PRINT 


- Direct ou 


QUALIFY 


- Mod i f y ba 


WHERE 


- Display s 



points and trace ranges 
kpoints and trace ranges 
specified 

debug f ac i 1 i t y 
stopped task 
ecution sequence 
g commands 
torage or registers 
eakpoints and trace ranges 
orage or registers 
vent or process interrupt 
tput to another terminal 
se address 
tatus of all tasks 






j Hon To Enter A Command 



A command is entered by pressing the ATTENTION key on your ter- 
minal and entering the command name* or the command name plus 
the required parameters for the command* in response to the 
prompting message '>'. 



Syntax Summary 



In the command syntax examples and descriptions in the follow- 
ing sections* keyword parameters are capitalized and variable 
parameters are shown in lower case. Whenever one of several 
keywords can be chosen* these keywords are separated by a 
slashC/). The examples show the various formats of each com- 
mand which are available for different purposes. Detailed syn- 
tax descriptions are presented under $DEBUG Command 
Descr i pt i ons . 
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$DEBUG 



Set breakpoints and trace ranges: 

AT ADDR address NOLIST/LIST NOSTOP/STOP 

AT TASK taskname start-add end-add EDX/ASM NOLIST/LIST 

NOSTOP/STOP 
AT ALL NOLIST/LIST NOSTOP/STOP 
AT * NOLIST/LIST NOSTOP/STOP 



Terminate $DEBUG: 

END 

Note: When the program being debugged is ended, $DEBUG 
mu s t be ended. 



Activate breakpoints or trace ranges 

GO ADDR address 

GO TASK taskname start-add end-add 

GO ALL 

GO * 



List $DEBUG commands: 



HELP 



Display storage or registers: 



LIST ADDR 

LIST RO. . .R7 

LIST #l/#2 

LIST IAR 

LIST TCODE 

LIST * 



address length mode 

taskname length mode 

taskname length mode 

taskname length mode 

taskname length mode 



Remove breakpoints or trace ranges: 

OFF ADDR address 

OFF TASK taskname start-add end-add 

OFF ALL 

OFF * 
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$DEBU6 






Modify storage or registers: 

PATCH ADDR address length mode 

PATCH R0...R7 taskname length mode 

PATCH #l/#2 taskname length mode 

PATCH IAR taskname length mode 
PATCH * 



Post events or process interrupts: 

POST ADDR address code 

POST PIxx code 

POST * 



Direct output to another terminal: 

PRINT terminal name 

PRINT * 

PRINT 



Modify base address: 

QUALIFY base disp 
Q base d i sp 1 



\^y 



Display status of all tasks: 
WHERE 



Display breakpoints and trace ranges 
BP 



Change execution sequence: 

GOTO current-address new-address 



o 
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Example: The command syntax permits most keyword 
be abbreviated to a single character, excep 
conflicts with ADDR; entry of AL for ALL and A fo 
mitted. You are prompted for command parameters 
unless you are sufficiently familiar with the syn 
complete command on a single line. For example»t 
TIMET into a program trace between addresses 
also print the contents of both task registers in 
decimal mode but continue processing, the folio 
tive keyboard sequence may occur. Each response 
by a RETURN key entry. 



parameters to 
t ALL which 
r ADDR is per- 
i nd i v i dua 1 ly , 
tax to enter a 
o set the task 
and 3000 and 

task L00P2 in 
wing i nterac- 

i s termi nated 






> AT 






OPTION(*/ADDR/TASK/ALL) : 


TASK 


FIRST ADDRESS: 0600 






LAST ADDRESS: 1000 






TRACE TYPECEDX/ASM) : 


EDX 




LIST/NOLIST: N 






ST0P/N0ST0P: N 






1 BREAKPOINT(S) SET 

,. ,_ _ 







Ident i ca 1 
response : 



results are obtained by entering the single 



> AT T TIMET 0600 1000 E N 
1 BREAKPOINT(S) SET 
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$DEBUG Command Descriptions 



J 



AT - Set Breakpoints and Trace Ranges 

AT sets breakpoints and trace ranges. The LIST and STOP options 
established for a breakpoint or trace range sre executed prior 
to executing the instruction that satisfied the breakpoint or 
trace range specification. When the specification for a break- 
point or trace range is satisfied, the task currently active is 
detoured and $ D E B U G performs the following actions for the sub- 
ject task: prints its status, prints the LIST specification, 
and optionally puts the task into a wait state. If the NOSTOP 
option was requested, task status is printed as "taskname 
CHECKED AT XXXX". The STOP option generates a "taskname 
STOPPED AT XXXX" message. 

The LIST and STOP options for all currently defined breakpoints 
and trace ranges can be modified by entering AT ALL. Similar- 
ly, the specifications for the most recently entered AT command 
can be altered by the AT * option. 



Notes : 

1. You cannot set breakpoints in ATTNLIST routines. 






2 . You can only set breakpoints on EDL instructions within an 
EDL program . 

Syntax 



AT ADDR address NOLIST/LIST NOSTOP/STOP 

AT TASK taskname start-add end-add EDX/ASM NOLIST/LIST 

NOSTOP/STOP 
AT ALL NOLIST/LIST NOSTOP/STOP 
AT * NOLIST/LIST NOSTOP/STOP 



Operands Descr i pt i on 

ADDR Keyword indicating this is an instruction program 
breakpoint specification. 

address Instruction address where a breakpoint is to be 
i nserted . 
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LIST - Display Storage or Registers 

LIST displays the contents of memory locations, or task regis- 
ters, or hardware registers, or the IAR. The LSB can be dis- 
played by listing the IAR with a length of 11 words. Any 
register data is only guaranteed to be current if the corre- 
sponding task is stopped by a $DEBUG breakpoint or trace range. 
To repeat the most recently specified LIST command or to verify 
(list) a patch you have just entered, use "LIST *". 

Syntax 



LIST 
LIST 
LIST 
LIST 
LIST 
LIST 



ADDR 
RO/. . 
f l/*2 
IAR 
TCODE 
* 



address length mode 

./R7 taskname length mode 

taskname length mode 

taskname length mode 

taskname length mode 






O perands Description 

ADDR Keyword indicating this is a display of a storage 
location. 



address Address of the storage location to be displayed. 

length Length of display in words, doublewords, or 
characters, depending on mode. 



mode 



Mode of data display: 



X - hexadecimal word 

F - decimal number(word) 

D - decimal number (doub leword ) 

A - relocatable address 

C - EBCDIC character 

R0/.../R7 One of the Series/1 hardware registers RO through 
R7. To define the start of the LIST. 



© 



taskname Name of task from which register data is to be 
displayed. For programs containing only a single 
task, omit this parameter. 



#l/#2 



Task register #1 or #2 specification. 
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IAR 



Keyword indicating the IAR (Instruction 
Register) is to be displayed. 



Address 






The most recently specified LIST specification is 
to be used. This is determined by the last usage of 
a LIST or PATCH command. 



TCODE 



Keyword indicating the task return code word(s) 
(first two words of the TCB) to be displayed. 



v_„x 



c 
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OFF - Remove Breakpoints and Trace Ranges 

OFF removes a breakpoint or trace range established with the AT 
command. To remove a breakpoint, specify the exact breakpoint 
address. To remove a trace request, specify the name of the 
task and an address range which brackets the addresses in the 
original trace request. To resume normal operations after 
removing trace requests, the task must be stopped at a break- 
point or trace range. If a task is currently stopped at the 
requested breakpoint or trace range, this task is automat- 
ically reactivated. 

Syntax 



OFF ADDR 

OFF TASK 

OFF ALL 

OFF * 



address 
taskname 



start-add end-add 



^k|l# 



Operands Description 

ADDR Keyword indicating this is the removal of the 
breakpoint specification. 

address Instruction address where a breakpoint has previ- 
ously been established. 

TASK Keyword indicating a trace range is to be removed. 

taskname Name of task associated with a trace range. For pro- 
grams containing only a single task, omit this 
parameter . 

start-add Trace range starting address. 

end-add Trace range ending address. 

ALL All breakpoints and trace ranges are to be removed. 

* The most recently referenced breakpoint or trace 

range specification is to be used. This specifica- 
tion is determined by the last usage of an AT, GO, 
or OFF command . 
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PATCH - Modify Storage or Registers 

PATCH modifies the contents of memory locations* task regis- 
ters, hardware registers, and the IAR (Instruction Address 
Register). The entire LSB (Level Status Block) can be modified 
by patching the IAR with a length specification of 11 words. 
The patch to any register data is only guaranteed if the corre- 
sponding task is inactive or stopped by a $ D E B U G breakpoint or 
trace range. To respec^fy the data for the most recent patch or 
to patch the data displayed by the most recent LIST command, 
enter 'PATCH *' . 

After the patch command is entered, the current memory or 
register content is displayed, and you are prompted for the 
patch data (a string of data entries that satisfy the length 
and mode specifications). The entries are separated by spaces, 
for example, data. ..data. After the patch data is entered, you 
can apply the patch by responding YES, abort by responding NO, 
or indicate additional patches with a CONTINUE reply to the 
prompting message. By specifying CONTINUE, the patch is 
performed and prompting continues for entry of new length, 
mode, and data specifications to memory or register locations 
immediately behind your previous patch. 

If less data than specified with the length operand is entered, 
the effective patch is padded with blanks for character data 
and zeros for all other data types. 

Syntax 






PATCH ADDR address 
PATCH ROV. . ./R7 
PATCH #l/#2 
PATCH IAR 
PATCH TCODE 
PATCH * 



length mode 
taskname length mode 
taskname length mode 
taskname length mode 
taskname length mode 



Operands Descr i pt i on 

ADDR Keyword indicating this is a storage patch. 

address Address of the storage location to be modified. 

length Length of patch in words, doublewords, 
characters depending on mode. 



or 
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mode 



Mode of data entry: 



$DEBUG 



X - hexadecimal word 

F - decimal number(word) 

D - decimal number ( doub leword ) 

A - relocatable address 

C - EBCDIC character 

R0/.../R7 One of the Series/1 hardware registers RO through 
R7> where the patch is to be started. 

taskname Name of task for which register data is to be 
modified. For programs containing only a single 
task* omit this parameter. 



#l/#2 
IAR 



Task register #1 or #2 specification. 

Keyword indicating the IAR (Instruction Address 
Register) is to be modified. 



TCODE 



Keyword indicating the task return code word(s) 
(first two words of the TCB) to be modified 

The most recently referenced LIST or PATCH specifi- 
cation is to be used and is determined by the last 
usage of a LIST or PATCH command 
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POST - Post an Event or Process Interrupt 

POST activates a task waiting for an event or a process inter- 
rupt. To duplicate a previous posting, enter POST *. The 
address of the ECB (Event Control Block) to be posted is con- 
tained in the second word of a WAIT command as shown on a pro- 
gram assembly listing. Process interrupts can also be posted 
by name, using the PIxx option. 

Syntax 



4 



POST ADDR address code 
POST PIxx code 
POST * 



Operands 

ADDR 

address 

code 

PIxx 



Descr i ot i on 

The address of an ECB (Event Control Block). 

ECB address to be posted. 

Decimal code to be posted to the specified ECB, 

Name of process interrupt PI1 to PI99. 

* The most recently referenced ECB address or PIxx 

name and code specification is to be used. 

PRINT - Direct Output to Another Terminal 

PRINT allows you to direct $DEBUG output to the specified ter- 
minal. For example, the output of a LIST command would appear 
on the specified terminal. 

Syntax 



PRINT terminal name 



Operands 



Descr i pt i on 



terminal name The terminal to which the output is to be 

d i rected 
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SS - Set Program Storage Parm : The following example shows 
reducing the dynamic storage to be allocated for the COBOL com- 
piler at program load. The SS command requires the size in 
bytes to be expressed in decimal. The value requested, if not 
an even multiple of 256, will be rounded up. 



> SDISKUT2 

USING VOLUME EDX002 
COMMAND (?): CV ASMLIB 

COMMAND (?) : SS $COBOL 

ENTER NEN STORAGE SIZE IN BYTES: 2816 

OLD STORAGE SIZE HAS 8448 

OK TO CONTINUE? Y 

COMMAND (?): EN 

$DISKUT2 ENDED AT 08:36:02 



c 



If an invalid value is entered, a message is issued stating the 
value must be in the range of to a maximum number of 6 4 K , 
minus the program size. 
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$DIUTIL - DISPLAY DATA BASE UTILITY 



v y 



$ D I U T I L maintains the disk resident data base used with graph- 
ics applications. This utility provides comprehensive facili- 
ties to keep the data base current by means of the following 
unctions? 

Initialize the Disk Resident data base 

De lete a member 

Reclaim space in data base due to deleted members 

Display contents of data base 

Copy data base 

Copy individual members of data base 

Allocate and build a data member 

his utility is normally used only when no other programs of 
he Display Processor are in use. The online data base can be 

changed or you may select another data base to be referenced. 

This allows you to create displays in a data base other than the 

online data base and then copy the members into the online data 

base after testing. 



V.-^ 



Invoking SDIUTIL 



To start execution of $DIUTIL: 

1 . Load the program $DIUTIL specifying the appropriate data 
set. $DIFILE> the online data set* or any other data set 
can be used. However* you should make sure that another 
user or program is not changing or using the same data set. 

2. The system responds with the Program Loaded message fol- 
lowed by : 



DISPLAY DATA 
COMMAND (?): 



BASE UTILITY 



c 



y 
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$DIUTIL 



CM - Copy Member 

Copies a member from the source data base to the target data 
base. The options available in MD are also included in CM. 



© 



COMMAND (?): CM 

SOURCE DATASET NAME: SDIFILE 

LOCATED ON VOLUME: EDX002 

CHANGE SOURCE DATASET? N 

TARGET (NAME, VOLUME): $DIFILE, EDX0O3 

SAVE EXISTING MEMBERS IN TARGET DATA BASE? Y 

ENTER MEMBER NAME TO BE COPIED 

PLOT 

PLOT COPIED 

COPY COMPLETED 

COMMAND (?): 



c 



The extents of the data set are not changed if a modified member 
can fit in the currently allocated space. If the modified mem- 
ber is larger than currently allocated space, then the old mem- 
ber is deleted and a new member must be allocated with larger 
extents. Space must exist in the data set for the copied 
member . 
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SDIUTIL 



DE - Delete a Member 






Removes display or data members from the data base. You 
prompted for the name of the member to be deleted and askc 
verify the accuracy of your entry prior to actual deletion. 



are 
ed to 



COMMAND (?): 
MEMBER NAME: 
DELETE MEMBER 
PLTT DELETED 

COMMAND (?): 



DE 
PLTT 

PLTT? 



EN - Exit Program 

Causes the Display Processor utility to be terminated. 



■<_^ 
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$DUMP 



Dump Part of Supervisor Partition to Printer (cont.) 






STORAGE MAP: 


$SYSCOM AT ADDRESS 3420 


PART# NAME 


ADDR 


PAGES 


TCB 


PI 


**PART** 


9F00 


97 




PI 


$TRAP 


9F00 


21 


B2B4 


PI 


**FREE** 


B400 


76 




P2 


**PART** 


0000 


256 




P2 


**FREE** 


0000 


256 




P3 


**PART** 


0000 


256 




P3 


**FREE** 


0000 


256 




P4 


**PART** 


0000 


256 




P4 


$SMMAIN 


0000 


4 


02F8 


P4 


$SMLOG 


0400 


34 


1978 


P4 


**FREE** 


2600 


218 
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$dump 






Dump Part of Supervisor Partition to Printer (cont.) 



TERMINAL LIST: 

NAME CCB ID ADDR 



$SYSLOG 

$TERM1 

STERM2 

SSYSLOGA 

$SYSPRTR 



1876 
1A82 
0C32 
1DCC 
1F86 



0406 0004 

040E 0005 

040E 0006 

0010 0000 

0306 0001 



DSK(ETTE) LIST: 
NAME DDB TYPE 



ID 



ORG 



SIZE 



LIB 



ADDR 



EDX001 


165E PRI 


0106 





75 2'i 


7 0002 


EDX002 


16F0 PRI 


00AA 





92 24. 


L 0003 IP 


ASMLIB 


1782 SEC 




92 


16 ] 




SUPLIB 


17A2 SEC 




108 


16 ] 




MACLIB 


17C2 SEC 




124 


78 ] 




EDX003 


17E2 SEC 




202 


102 ] 




SUPV BEGINNING AT 


ADDRESS 


0000 FOR 


139 PAGES 





0000 



6802 882A 0000 0000 8968 8826 8969 8826 



0010 0000 0000 8968 8826 0A76 0A12 8968 8826 

SAME AS ABOVE 
0100 12DC 8BC2 0004 0006 1010 6A08 03F8 5B22 |...B 



ANOTHER AREA? (Y/N): N 



Note 



Note : $DUMP allows you to request several partial dumps. If a 
f Y' response is entered, then $DUMP prompts you for the start- 
ing and ending addresses that are to be dumped. See note 4. 



y 
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$EDIT1 and $EDIT1N 



$EDIT1 AND $EDIT1N - LINE EDITORS 



$EDIT1 and SEDIT1N provide a text editing facility (primarily 
used for source program entry and editing) that can be invoked 
simultaneously with the execution of other programs. The Host 
Communication Facility related version ($EDIT1) provides a few 
commands for data communication using the Host Communications 
Facility IUP on the System/370 so that almost the entire proc- 
ess of program preparation can be controlled from a Series/1 
terminal. The native program preparation version ($EDIT1N) 
produces members that can be processed by the Series/1 assem- 
bler. 

Both versions work with 80-character lines that are line num- 
bered in positions 73-80 and are invoked by the $ L command. 



Data Set Requirements 






One work data set is required by the editing facility and must 
be allocated on disk or diskette using $DISKUT1. You are 
prompted for its name when either version is loaded. This data 
set contains both your data and some index information during 
the editing session, and the size (number of records) of the 
data set determines the maximum number of data records that it 
can contain. It is divided into three parts: 



© 



1. One header record 

2 . A series of index records (32 entries per record) 

3. A series of data records (3 entries per record) 

The required data set size can be calculated as follows: number 
of text lines (n) divided by 30, times 11, plus 1 ((n/30 x 11) + 
1) . 
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$EDIT1 and $EDIT1N 



Sequence of Operations 



When the edit program is loaded, it prompts you for the name of 
the work data set to be used. If an existing data set is to be 
edited, the READ command should be used to copy the data set to 
the work data set. For a new data set, edit mode should be 
invoked. The contents of the work data set can be printed using 
the LIST command. 

The EDIT command is used to enter edit mode. Edit subcommands 
are then recognized until terminated by the END command. 

Note : You should use the VERIFY ON subcommand until you become 
familiar with the editing process. 

The TABSET subcommand is used, if desired, to specify the tab 
character and tab column. This eliminates the entry of blanks 
when a substantial amount of the text to be entered is in tabu- 
lar format or begins in a particular column. 



zf^\ 



Data can be entered a line at a time under the INPUT subcommand 
(recommended for new data sets and bulk sequential updates 
because of the automatic prompting feature) or by using the 
line editing function (for single line corrections). Portions 
of the edited data can be listed at the terminal using the LIST 
command . 



v^y 



The position of the current line pointer is controlled by the 
FIND, TOP, BOTTOM, UP, and DOWN subcommands. 

Edit mode is terminated with the END command. When the text has 
been edited, copy the work data set to a permanent data set 
using either the WRITE or SAVE subcommand. The work data set is 
in a blocked format that is incompatible with most Event Driven 
Executive functions. Automatic translation from text editor 
format to source statement format is performed. 



The following figure shows the primary commands 
mands available under $EDIT1/$EDIT1N . 



and subcom- 



c 
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$FONT 



$FONT - PROCESS 4978 CHARACTER IMAGE TABLES 



$ F N T creates or modifies the character image tables for the 
4978 display station and the 4974 matrix printer. These 
devices have an image store, containing the bit patterns which, 
when interpreted by the hardware, result in the display or 
print of characters on the screen or printer. Each character 
bit pattern is associated with an EBCDIC code and is defined by 
a dot matrix that is coded into eight bytes of data. These bit 
patterns can be changed to alter the appearance of the charac- 
ters displayed, or if desired, to create entirely new 
characters . 

You can use the 4979 display station to change the character 
image tables of a 4978 display station or a 4974 matrix 
printer. However, the DISP command of $FONT will not display 
the character image for the device being modified. The charac- 
ter set of the 4979 will be displayed. 

Note: The image buffer of the 4974 can be restored to the 
standard 96-character set by using the RE command of 
$TERMUT2. 



Invoki ng $FONT 

$F0NT is invoked by the $L command or primary option 4 of the 
session manager . 
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$FONT 



$FONT Commands 



^f \ 

KJ 



The commands available under $ F N T are listed below. To dis- 
play this list at your terminal; enter a question mark in 
response to the prompting message COMMAND (?)*.. 



COMMAND (?): ? 



DISP 


-- 


EDIT 


-- 


SAVE 


-- 


PUT 


-- 


GET 


-- 


END 


— 


COMMAND 



DISPLAY TABLE 
ENTER EDIT MODE 
SAVE TABLE 
LOAD TABLE INTO 
READ TABLE FROM 
END PROGRAM 

(?) : 



DEVICE 
DEVICE 



After the commands are displayed, you are again prompted with 
COMMAND (?)*.. You respond with the command of your choice (for 
examp le , GET ) . 



~n 



Data Set Requirements 

$FONT requires a preallocated data set of 2048-bytes (8 
records) for the 4978 or 768-byte (3 records) for the 4974. The 
data set can contain the character image table, or it can rep- 
resent storage for a new table to be constructed. 

The 4978 and 4974 image stores may be loaded from a disk or 
diskette data set. With the exception of the 4978, you should 
allocate an image store data set before using $FONT. Use 
$DISKUT1 to allocate the data set. 

For the 4978, the system-supplied image store data sets 
$4978IS0 or $4978CS0 can be used with $FONT. However, these 
data sets are automatically loaded to every 4978 supported by 
the supervisor at initialization, and modifications made will 
be reflected in all the displays. This may not be desirable in 
all cases . 
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DISP - Display Table 



$FONT 



The DISP command displays all 256 EBCDIC codes* along with the 
characters that are generated for each code by the associated 
bit patterns in the image store. However* the 4974 matrix 
printer supports a 96 character set; therefore* only the 96 
support characters are displayed and the unsupported charac- 
ters are left blank. For descriptions of the characters sup- 
ported by the 4974 matrix printer and the 4978 display 
stations, see the 4974 Printer Description and the 4978 General 
Inf oritiat i on manuals. 

If the data set to contain the image store was just allocated, 
and does not contain an image table, a meaningless display will 
result. To acquire an image table to work with, use the GET 
command to read an image table from the 4978 or 4974. 



DISP Example 

This screen display is in compressed format and does not show 
the entire image table as it would be displayed. 






COMMAND 


(?) 


: GET 














TERMINAL NAME: 


DSPLAY1 












COMMAND 


(?) 


: DISP 














00 


10 


20 


30 


40 


508 


60- 


CO 


DO 


E0 


F00 


01 


11 


21 


31 


41 


51 


61 


. . CIA 


D1J 


El 


FU 


02 


12 


22 


32 


42 


52 


62 


C2B 


D2K 


E2S 


F22 


03 


13 


23 


33 


43 


53 


63 


C3C 


D3L 


E3T 


F33 


04 


14 


24 


25 


44 


54 


64 


C4D 


D4M 


E4U 


F44 


05 


15 


25 


35 


45 


55 


65 


C5E 


D5N 


E5V 


F55 


0D 


ID 


2D 


3D 


4D( 


5D) 


6D- 


CD 


DD 


ED 


FD 


0E 


IE 


2E 


3E 


4E 


5E! 


6E> 


. . CE 


DE 


EE 


FE 


OF 


IF 


2F 


3F 


4F| 


5F- 


6F? . . 


CF 


DF 


EF 


FF 



© 



The characters are displayed to the right of the EBCDIC codes 
with which they are associated. To modify or create a charac- 
ter, EDIT mode must be entered. Display mode is ended by press- 
ing the ENTER key and the COMMAND (?): prompt will appear 
again. You can then enter EDIT mode. 

Note: If you are using a 4979 to change a 4978 or 4974 image 
store, the DISP command will display the character set of 
the 4979 and not the current image table of the 4978 or 4974. 
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$FONT 
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EDIT - Enter Edit Mode 

The EDIT command is used to modify or create characters in the 
image table. An enlargement of a dot matrix pattern (a 4 x 8 
grid) is displayed. This grid is used to create or modify char- 
acters within the current image table. 



COMMAND 


C?) : 


EDIT 


PF1 


— 


TAB 


FORWARD 


PF2 


-- 


TAB 


BACK 


PF3 


-- 


NEXT LINE 


PF4 


-- 


INVERT DOT 


ENTER 


-- 


SET 


PATTERN 


PF5 


__ 


COMMAND MODE 



CODE 



( ) 






v_y 



For each grid row> the center of seven overlapping dot areas 
occur at the centers of each of the four squares and at each of 
the three interior grid lines. 



/f 
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GET - Read Table from Device 

The GET command reads the image store from a 4978 or 4974 into 
the preallocated work data set and that image store becomes the 
current table. The GET command followed by a SAVE provides a 
means for initializing a data set with a character image table. 



Synta x 



GET device 

Required: device 

Default: terminal from which you invoked 5F0NT 



Operands Description 

device Name of the device (specified on the TERMINAL 
statement) whose image table is to be read into the 
work data set 






If you do not specify a device name on the same line as the GET 
command, you are prompted as follows: 



TERMINAL NAME: 



If you do not enter a name following the prompt and press ENTER, 
GET defaults to the terminal from which you invoked $FONT. If 
the device is not a 4978, the following message is issued: 



DEVICE NOT SUPPORTED 
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GET Examples 



COMMAND (?): GET 
TERMINAL NAME: DSPLAY1 



\„y 



COMMAND (?): GET DSPLAY1 



\_J 



c 
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PUT - Load Table into Device 

The PUT command loads the specified device with the altered or 
new image table. The image table is only current for the par- 
ticular device until its image store is loaded with a different 
image table. Also, the image store will revert to its original 
state when the system is initialized again or there is a power 
failure. 

Note I Loading a specified device with an altered or new 
image table can also be accomplished using the LI command 
(load a control store) of $TERMUT2. 

Syntax 



PUT device 

Required: device 

Default: terminal from which you invoked $FONT 






Operands Descr i pt i on 
device 



Name of the device (specified on the TERMINAL 
statement) whose image store is to receive the cur- 
rent tab le 



If you do not specify a device name on the same line as the PUT 
command, you are prompted as follows •* 



TERMINAL NAME: 



If you do not enter a name following the prompt and press ENTER, 
PUT defaults to the terminal from which you invoked $FONT. If 
that device is not a 4978, the following message is issued: 



DEVICE NOT SUPPORTED 
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PUT Examples 



/0 X 



COMMAND (?): PUT 
TERMINAL NAME: DSPLAY1 



COMMAND (?): PUT DSPLAY1 



SAVE - Save Table 

The SAVE command writes the current image table, reflecting any 
changes made during edit mode, to the data set designated at 
load time. 

Syntax 



SAVE 

Requ i red : none 

Default: SAVE attempts to store the current image table 
in the data set allocated for the 4978 



If you just specify SAVE, the table is saved for the 4978 
you specify 4974, the table is saved for the 4974. 



If 



SAVE Examples 



COMMAND (?): SAVE 



COMMAND (?): SAVE 4974 
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Creating or Modifying a Character Image Table 

When edit mode is first entered, a 4 x 8 grid is displayed in 
the center of the screen as follows: 






COMMAND (?): EDIT 

PF1 — TAB FORWARD 


PF2 — TAB BACK 1 1 1 1 1 

PF4 — INVERT DOT 1 1 1 1 1 
ENTER — SET PATTERN I . . . . | . . . . | . . . . | . . . . | 
PF5 — COMMAND MODE 1 1 1 1 1 

CODE ( ) 1 1 1 1 1 



For each grid row, the center of seven overlapping dot areas 
occur at the centers of each of the four squares and at each of 
the three interior grid lines. 

The cursor is positioned just to the right of the CODE prompt on 
the bottom left of the screen. You can now enter a character in 
the present cursor position, or move the cursor to the right 
and enter an EBCDIC code between the parentheses. Once you 
have entered a character, $FONT fetches the bit pattern for 
this character, displays the character image in the image grid, 
and places the cursor in the top left-hand square of the 4 by 8 
image grid. The EBCDIC code for the character entered is 
placed in the parentheses to the right of the CODE prompt. The 
character is also displayed below the character image grid 
(4978 only - not 4979) . 

You can then proceed to move the cursor about within the image 
grid by the PF key functions described on the screen. The PF 
keys function as follows: 



PF1 Moves the cursor forward 
top-to-bottom) across the grid 



(left-to-right, 



and 
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PF2 Moves the cursor backwards within the grid (right-to-left 
and bottom-to-top) 

PF3 Moves the cursor from its present line down to the next 
line* and position it in the leftmost square of the new 
1 i ne 

PF4 Inverts the dot pattern and extends the crossbars down- 
ward 

PF5 Returns you to command mode or cancels the current edit 
session. If the edit session is cancelled, the modified 
image will not replace the original image. To return to 
command mode once you have cancelled the edit session, 
press PF5 a second time. 

The following shows a screen format after you select a charac- 
ter for display. In this example, the letter T was entered. 






COMMAND (?): EDIT 

PF1 — TAB FORWARD 

PF2 — TAB BACK I I I I I I I I I I I I I I 1 I I I I I I 

PF3 -- NEXT LINE I I I I I I I I I I I I I I I I I I I I I 

PF4 -- INVERT DOT I I I I I I I I I 

ENTER -- SET PATTERN | I . . I I I I I . . I I 

PF5 — COMMAND MODE | | I I I I I I I 

CODE T (E3) I I I I I I I I I 

T 



W 



By moving the cursor about the image table with the PF keys, you 
can position the cursor on the screen for modification. In the 
following display, PF3 has placed the cursor in the position 
needed to begin modification of the T, The T will be altered by 
extending the ends of the top crossbar downwards. The cursor 
is now in a position to do that. 
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COMMAND (?): EDIT 

PF1 — TAB FORWARD 

PF2 — TAB BACK I I I I I I I I I I I I I ! I I I I I I I 

PF3 — NEXT LINE I I I I I I i I I I I I I I I I i I I I I 

PF4 — INVERT DOT I _ I I I I I I I I 

ENTER — SET PATTERN I I..IIIII..I I 

PF5 -- COMMAND MODE I | 1 I I I I I I 

CODE T (E3) | | I I I I I I I 

T 






By pressing the PF4 key (invert dot), the dot pattern in the 
first square of the second line is inverted, which extends the 
left end of the crossbars downward. The image will appear as 
f o 1 lows : 



COMMAND (?): EDIT 

PF1 ~ TAB FORWARD 

PF2 — TAB BACK I I I I I I I I I I I I I I I I I I I I I 

PF3 — NEXT LINE I I I 1 I I I I I ! I i I I I I I I I I ! 

PF4 -- INVERT DOT I I I I I I Mill I I 

ENTER -- SET PATTERN I I I I I I .. I I I I I .. I I 

PF5 -- COMMAND MODE | | Mill I I 

CODE T (E3) | | MM! I I 

T 
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As modifications are made within the grid, they are reflected ^— ^ 

in the actual size character below the grid. You continue ; 

using the cursor to move about the grid and modify the image as - 
des i red . 

Once you have completed modifying the image, press ENTER. The 
CODE prompt is changed to SET and the cursor is positioned just 
to the right of the SET prompt. At this point, you can either 
"set" the character just composed into the image table or can- 
cel the changes made to the image. To "set" the character just 
composed into the image table, press ENTER and the modified T 
will replace the original iT. To cancel the current edit ses- 
sion, press PF5. The SET prompt will be changed back to the 
CODE prompt and you can enter the character you wish to modify. 
If you press PF5 a second time, you are returned to command 
mode . 

You also have the option of associating the modified T with a 
different key or EBCDIC code. If, for example, you type A on 
top of the T next to the SET prompt and then press ENTER, the 
modified T will replace the character A. If you move the cursor 
to the right and overtype the E3 within the parentheses with 
the EBCDIC code (FO), the modified T image would replace that 
for . 

By pressing the ENTER key without altering the character or 
EBCDIC code, the character is set, the CODE prompt is again 
displayed, and $FONT is ready for another character or EBCDIC V.^ 

code to be entered. 

To end EDIT mode, press PF5 and reenter command mode. If you 
want to be able to load the modified image store to a 4978 or 
4974 at a future time, the image store must be stored on disk or 
diskette. Use the SAVE command to store the modified image in 
the data set specified when $ F N T was invoked. 



w 



,> 
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$FSEDIT 



Option 5 - SUBMIT 

The SUBMIT option injects a job CJCL and optional data) into 
the host job stream. The display and operation are similar to 
the READ and WRITE commands. The data set name entered must be 
the fully qualified name of the host data set containing the 
JCL to be submitted. If the keyword DIRECT is entered instead 
of a data set name, the contents of the work data set are trans- 
ferred directly into the host job stream. The SUBMIT to host 
requires the Host Communications Facility on the System/370. 

Note ' The DIRECT option is only to be used in systems with a 
HASP or JES2 interface. 

Option 6 - LIST 

The LIST option prints the entire contents of the work data set 
on the hardcopy device assigned to the terminal. (The listing 
can be terminated at any time by pressing the ATTN key and typ- 
ing CA. ) 



c 



Opti on 7 - MERGE 

The MERGE option merges all, or part, of a source data set into 
the current edit work data set. You are prompted for the names 
of the Series/1 source data set and volume. If the specified 
data set is found, you are then prompted for the first and last 
line numbers of the data to be copied. You are also prompted 
for the line number of the current work data set after which the 
data is to be added. For example: 



MERGE DATA FROM ( NAME , VOLUME ) 



ADD TO 



SRCEDATA 

LINES- 1ST LAST 
TARGET AFTER LINE 



#: 



10 430 
1050 



If the entire source data set is to be merged, an asterisk is 
entered instead of the source data line specification, as 
f o 1 lows : 



MERGE DATA FROM ( NAME , VOLUME ) 



ADD TO 



SRCEDATA 

LINES- 1ST LAST 
TARGET AFTER LINE 



#: 



490 
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The specification of an asterisk should only be used for the 
source data set. (If the format of the line number specifica- 



tion is incorrect, an 
prompted for the data 
the data is then read 
current work data set, 
bered . 



error message is displayed and you are 
again.) If all parameters are correct, 
from the source data set, added to the 
and the current work data set is renum- 






MERGE DATA FROM ( NAME , VOLUME ) : SRCEDATA 

LINES- 1ST LAST 
ADD TO TARGET AFTER LINE 



#: 



10 430 
1050 



Caut i on i Once the merge has started, it must be allowed to com- 
plete normally or unpredictable results may occur. Series/1 
source data sets are defined to consist of 80 character lines 
which are numbered in columns 73-80. 



/T^ 
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$FSEDIT 



Option 8 - END 

The END option terminates $FSEDIT. 

Option 9 - HELP 

The HELP option displays tutorial text on the use of $ F S E D I T 



V -J 



Primary Commands 



Primary commands are entered on line 2 of the display in the 
Command Input Field. All primary commands can be entered while 
in edit mode. In browse mode, three primary commands are 
recognized by $FSEDIT: LOCATE, FIND, MENU. 

Most of the primary commands can be entered in abbreviated for- 
mat. Only the first character is required. Minimum free form 
format is indicated with each command enclosed in (). 

The function of each of the primary commands is described on 
the following pages. 



ff 
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SIAMUT1 



$IAMUT1 - BUILD AND MAINTAIN INDEXED DATA SET 



$ I A M U T 1 helps you manage your indexed data sets. The $ I A M U T 1 
utility is shipped with an input/output buffer of 512 decimal 
bytes. This allows you to define an indexed data set with a max- 
imum block size of 512 bytes, and to load, unload* and reorgan- 
ize indexed data sets with a maximum record size of 512 bytes. 
If you want to change the maximum record size, refer to the 
Program Directory for use with Version 1 , Modification level 2 
of program 5719-AM3, section J, Programming Considerations 

$IAMUT1 can be invoked using the $L command, $JOBUTIL, or the 
Session Manager. 



$IAMUT1 Commands 



The commands available under SIAMUT1 are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 



ENTER COMMAND (?): ? 

CR - INVOKE $DISKUT1 

EC - SET/RESET ECHO MODE 

EN - END THE PROGRAM 

SE - SET DEFINE PARAMETERS 

DF _ DEFINE AN INDEXED FILE 

DI _ DISPLAY CURRENT SE PARAMETERS 

RE _ RESET CURRENT VALUES FOR DEFINE 

LO - LOAD INDEXED FILE FROM SEQUENTIAL FILE 

RO - REORGANIZE INDEXED FILE 

UN - UNLOAD INDEXED FILE TO SEQUENTIAL FILE 

ENTER COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command for of your choice 
( for example , EC) . 
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CR - Create Data Set 



"^K 



v...y 



CR allocates space for your data set in a volume by internally 
invoking the $DISKUT1 utility. The SE command should have been 
used to determine the number of records to allocate. When CR is 
entered on a terminal* the $DISKUT1 utility is loaded. You can 
then use the AL command of $DISKUT1 to allocate a data set; any 
other $DISKUT1 function can also be performed. Communication 
to the $DISKUT1 utility continues until the END command (EN) is 
entered* at which time communication to $ I A M U T 1 is restored. 
For information on the $DISKUT1 utility, refer to "$DISKUT1 - 
Allocate /Delete; List Directory Data" on page 135. 

Note : Echo mode is not active during use of $DISKUT1. 

The following example shows a use of the CR command: 



ENTER COMMAND (?): 
$DISKUT1 ACTIVE 
USING VOLUME EDX002 



CR 



COMMAND (?): AL SAMPLE1 
HOW MANY RECORDS? 72 
DEFAULT TYPE = DATA - OK? 
SAMPLE1 CREATED 

ENTER COMMAND (?): 



(T 



\ j 
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DF - Define Indexed Data Set 

DF command defines an indexed data set using an existing data 
set and the information you specify. When DF is entered, you 
are prompted for the immediate write back option and the names 
of the data set and volume to be formatted. Size calculations 
are made and the data set is formatted. The size calculation 
information is returned to you at your terminal on completion 
of the DF command. Before entering DF, you must use the SE 
command to set up parameters that determine the size and format 
of the indexed data set. The data set must have been allocated 
previously (the CR command can be used to allocate it). 

DF allows you to select the immediate write back option. With 
this option, each modification to the indexed data set records 
that is the result of your request to update a data record is 
written to the data set immediately, thus contributing to the 
integrity of the data set. If you enter N to the immediate write 
back prompt, modifications are held in the main storage buffers 
for a period of time before being written back to the indexed 
data set. In most cases, not using the immediate write back 
option often results in fewer I/O operations and in better per- 
formance. 

The following example shows a use of the DF command: 



ENTER COMMAND (?): DF 

DO YOU WANT IMMEDIATE WRITE-BACK? N 

ENTER DATASET ( NAME , VOLUME ) : SAMPLEl , EDX002 



After entering the above information, the following 
p layed : 



is d i s 
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TOTAL LOGICAL RECORDS/DATA BLOCK: 

FULL RECORDS/DATA BLOCK: 

INITIAL ALLOCATED DATA BLOCKS: 

INDEX ENTRY SIZE: 

TOTAL ENTRIES/INDEX BLOCK: 

FREE ENTRIES/PIXB: 

RESERVE ENTRIES/PIXBCBLOCKS) : 

FULL ENTRIES/PIXB: 

RESERVE ENTRIES/SIXB: 

FULL ENTRIES/SIXB 

DELETE THRESHOLD ENTRIES: 

FREE POOL SIZE IN BLOCKS: 

# OF INDEX BLOCKS AT LEVEL 1: 

# OF INDEX BLOCKS AT LEVEL 2: 

# OF INDEX BLOCKS AT LEVEL 3: 

DATA SET SIZE IN EDX RECORDS: 
INDEXED ACCESS METHOD RETURN CODE 
SYSTEM RETURN CODE: 
ENTER COMMAND (?): 



3 

2 
50 
32 
7 
1 

6 

7 
7 

9 
2 
1 

73 
-1 
-1 



X.,-^ 
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DI - Display Parameter Values 

DI displays the current parameter values entered via the SE 
command. The parameter values can be used to format a data set 
via the DF command or they can be modified by reusing the SE 
command . 

The following example shows a use of the DI command. 



ENTER COMMAND (?): DI 
CURRENT VALUES FOR SE 

BASEREC 100 

BLKSIZE 256 

RECSIZE 80 

KEYSIZE 28 

KEYPOS 1 

FREEREC 1 

FREEBLK 10 

RSVBLK NULL 

RSVIX 

FPOOL NULL 

DELTHR NULL 

DYN NULL 

ENTER COMMAND (?) : 



COMMAND ARE 
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EC - Control Echo Mode 

EC allows you to enter or leave echo mode. When in echo mode* 
all $IAMUT1 input and output is logged on the $SYSPRTR device. 
This allows you to save information about the data sets you 
maintain using SIAMUT1. When in echo mode, all input and out- 
put is logged until either the current utility session is ended 
or echo mode is reset by use of the EC command. Echo mode is off 
when SIAMUT1 is loaded. 

Note i Input and output from $DISKUT1 (CR command) is not 
logged . 

The following examples show the commands to set and reset echo 
mode : 






ENTER COMMAND (?): EC 

DO YOU WANT ECHO MODE? (Y/N) Y 

ENTER COMMAND (?): EC 

DO YOU WANT ECHO MODE? (Y/N) N 

ENTER COMMAND (?): 



(Set echo mode) 
(Reset echo mode) 



'V,^ 
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RE - Reset Parameters 

RE resets the parameters set up by the SE command to their 
default va lues . 

The following example shows a use of the RE command: 



ENTER COMMAND (?) : RE 
ENTER COMMAND (?): 
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SE - Set Parameters 

S E prompts you for parameters that determine the structure and 
size of the indexed data set. The parameter values entered are 
saved by $ I A M U T 1 . This allows you to reuse the SE command to 
change one or more parameters without having to reenter all of 
them. The current values can be displayed by the DI command. 

Note : The values are retained only as long as $ I A M U T 1 remains 
loaded . 

Size calculations are performed using the parameter values you 
have specified. The results are returned to you at your termi- 
nal. The SE command can be followed by the CR command to create 
a data set of the size specified on the SE command. After the 
data set has been allocated, or if a data set of the correct 
size already exists, the DF command can be used to format it. 

The following list shows the default values for parameters on 
the SE command (all values are decimal): 



BASEREC 


NULL 


BLKSIZE 





RECSIZE 





KEYSIZE 





KEYPOS 


1 


FREEREC 





FREEBLK 





RSVBLK 


NULL 


RSVIX 





FPOOL 


NULL 


DELTHR 


NULL 


DYN 


NULL 






If the default value is acceptable, enter a null line for the 
parameter when prompted for it. If you wish to change the value 
for any parameter, enter the new value in response to the 
prompting message. The new value becomes the new default value 
for the current $IAMUT1 session. The only parameters for which 
a null can be specified are BASEREC, FREEREC, FREEBLK, RSVBLK, 
RSVIX, FPOOL, DELTHR, and DYN. To specify a null parameter 
after the original default has been modified, enter an amper- 
sand (&) in response to the prompting message. For an explana- 
tion of the SE command parameters, refer to "Determining Data 
Set Size and Format" on page 247. 

The following example shows a use of the SE command in estab- 
lishing the size and structure of an indexed data set. 
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ENTER COMMAND 


(?) : SE 




PARAMETER 


DEFAULT NEW VALUE 


BA5EREC 


NULL 


100 


BLKSIZE 





256 


RECSIZE 





80 


KEYSIZE 





28 


KEYPOS 


1 


1 


FREEREC 





1 


FREEBLK 





10 


RSVBLK 


NULL 




RSVIX 







FPOOL 


NULL 




DELTHR 


NULL 




DYN 


NULL 





^>L l , 1 ..,y 



After the above information has been entered, the following is 
displayed showing the size and structure of the defined indexed 
data set . 



TOTAL LOGICAL RECORDS/DATA BLOCK: 

FULL RECORDS/DATA BLOCK: 

INITIAL ALLOCATED DATA BLOCKS: 

INDEX ENTRY SIZE: 

TOTAL ENTRIES/INDEX BLOCK: 

FREE ENTRIES/PIXB: 

RESERVE ENTRIES/PIXBCBLOCKS) : 

FULL ENTRIES/PIXB: 

RESERVE ENTRIES/SIXB: 

FULL ENTRIES/SIXB 

DELETE THRESHOLD ENTRIES: 

FREE POOL SIZE IN BLOCKS: 

# OF INDEX BLOCKS AT LEVEL l: 

# OF INDEX BLOCKS AT LEVEL 2: 

# OF INDEX BLOCKS AT LEVEL 3: 

DATA SET SIZE IN EDX RECORDS: 
INDEXED ACCESS METHOD RETURN CODE 
SYSTEM RETURN CODE: 
ENTER COMMAND (?): 



50 
32 
7 
1 

6 

7 
7 

9 
2 
1 

73 
-1 
-1 
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UN 



Unload Indexed Data Set 



*? 



UN unloads an indexed data set to a sequential data set. The 
record lengths of the two data sets need not be the same. 
Unloaded records are truncated or padded with zeros if the 
records lengths of the two data sets differ. Refer to the LO 
command . 

Records are placed in the sequential data set in ascending key 
sequence as indicated by the indexed data set. Unloaded records 
are not blocked. They can span two or more 256 byte records. If 
the indexed data set contains more records than are allocated 
in the sequential data set, you are given the option to contin- 
ue unloading to another sequential data set. If you choose to 
continue unloading, you are prompted for the name of the data 
set and volume to use to continue the unload operation. The 
unload operation continues, putting the records read from the 
indexed data set into the new sequential data set. 

Not e : The record length of subsequent output sequential data 
sets is assumed to be the same as the initial output sequential 
data set . 

If the end of the output data set is reached and you choose not 
to continue, the unload operation ends. 

Cauti on* Do not specify the same data set for input and output. 

The following is an example of the commands and responses of an 
UN command : 



ENTER COMMAND (?): UN 

UNLOAD ACTIVE 

ENTER INPUT DATASET ( NAME , VOLUME ) : SAMPLE1, EDX002 

ENTER OUTPUT DATASET ( NAME , VOLUME ) : SAMPLE2, EDX002 

OUTPUT RECORD ASSUMED TO BE 80 BYTES. OK?: N 

ENTER RECORD SIZE: 256 

UNLOAD IN PROCESS 

END OF INPUT D/S 

100 RECORDS UNLOADED 
UNLOAD SUCCESSFUL 
ENTER COMMAND (?): 



c 
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Building an Indexed Data Set 

The S E and DF commands allow you to specify the size and format 
of your indexed data set and to do the actual data set format- 
ting. Use the SE command to enter those values that determine 
the size of the indexed data set. Use the DF command to actually 
format the data set using the values previously specified on 
the SE command . 

If the data set is too small to support the specified format, 
the amount of space required is returned to you. Knowing the 
available space and using the SE command, you can vary the SE 
parameters to design a data set of proper size. 



Determining Data Set Size and Format 






o 



The data set design is determined by these SE command parame- 
ters : 

BASER EC The estimated number of records to be loaded into the 
data set in ascending key sequence. These records 
can be loaded by $IAMUT1 or by a PUT request after 
either a LOAD or PROCESS request. 

BASEREC should never be zero. If the DYN parameter 
is specified, the BASEREC parameter need not be 
specified, and defaults to 1. If the DYN parameter 
is not specified, the BASEREC parameter must be 
specified. 

BLKSIZE The length, in bytes, of blocks in the data set. It 
must be a multiple of 256. 

RECSIZE The length, in bytes, of records in the data set. 
Record length must not exceed block length minus 16. 

KEYSIZE The length (1 to 254 bytes) of the key to be used for 
this data set . 

KEYPOS The position, in bytes, of the key within the record. 
The first byte of the record is position 1. 

FREEREC The number of free records to be reserved in each 
block. It should be less than the number of records 
per block (block size minus 16, divided by record 
size). It defaults to zero. 



Chapter 4. The Utilities 



247 



PageofSC34-0313-2 

As updated February 13, 1981 

By TNL SN34-0684 



$IAMUT1 



FREEBLK The percentage (0-99) of each cluster to reserve for 
free blocks. The percentage calculation result is 
rounded up so that at least one free block results. 
The calculation is adjusted to ensure that there is 
at least one allocated block in the cluster; that is, 
there cannot be 100% free blocks. This value 
defaults to zero. 



vy 



RSVBLK The percentage of the entries in each lowest level 
index block to reserve for cluster expansion. These 
reserved entries are used to point to new data blocks 
as they are taken from the free pool to expand the 
cluster. The result of the calculation is rounded up 
so that any non-zero specification indicates at 
least one reserved index entry. The calculation is 
adjusted to ensure that there is at least one allo- 
cated block in the cluster. Enter a null character 
(*) for this prompt if you do not want initial 
reserved blocks and do not want the indexed access 
method to create reserved blocks as records are 
deleted and blocks become empty. Specify a value of 
zero for this prompt if you do not want initial 
reserved blocks but you do want the indexed access 
method to create reserved blocks as records are 
deleted and blocks become empty (See the DELTHR 
prompt). Note that the sum of the FREEBLK and RSVBLK 
prompts should be less than 100. This value defaults 
to null if the DYN parameter is not specified. If 
the DYN parameter is specified, this value defaults 
to zero . 

RSVIX The percentage (0-99) of the entries in each second 
level index block to reserve for use in case of clus- 
ter splits. A cluster split is required when a clus- 
ter expands to its maximum potential size (as 
defined by the RSVBLK prompt) and another data set is 
inserted into the cluster. Each cluster split uses 
one reserved entry of the second level index block. 
The result of this calculation is rounded up so that 
any non-zero specification indicates at least one 
reserved index entry. The calculation is adjusted so 
that there is at least one unreserved entry in each 
second level index block. This value defaults to 
zero . 






FPOOL The percentage (0-100) of the maximum possible free 
pool to allocate. The RSVBLK and RSVIX prompts 
result in a data set structure capable of drawing on 
the free pool for expansion. If insertion activity 
is evenly distributed throughout the data set, every 
reser>fB entry of every index block can be used. The 
number of blocks drawn from the free pool to support 



.> 
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DYN 
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this highly unlikely condition is the maximum free 
pool size needed for the data set. In more realistic 
cases* insertion activity is not evenly distributed 
throughout the data set, so fewer free blocks are 
needed. The percentage specified here represents the 
evenness of the distribution of inserted records. 
Specify a large number (90, for example) if you 
expect insertions to be evenly distributed. Specify 
a small number (20, for example) if insertions are 
anticipated to be concentrated in specific key 
ranges. If null is specified for this prompt, a free 
pool is not created for this indexed data set. If 
zero is specified, an empty free pool is created. 
Blocks can then be added to the free pool as records 
are deleted and blocks become empty (see the DELTHR 
prompt explanation). If you do not specify a null for 
this prompt, the RSVBLK must not be null and/or the 
RSVIX must be non-zero or an error is returned. 
Conversely, if the RSVBLK and/or RSVIX is non-zero, 
FPOOL must not be null or an error is returned. 

The percentage (0-99) of blocks to retain in the 
cluster as records are deleted and blocks made 
available. This is known as the delete threshold. 
When a block becomes empty, it is first determined if 
the block should be given up to the free pool by 
checking the response to this prompt. If the block is 
not given up to the free pool, it is retained in the 
cluster, either as a free block or as an active empty 
block. The result of this calculation is rounded up 
so that any non-zero specification indicates at 
least one block. If the DELTHR parameter is speci- 
fied as null and the DYN parameter is not specified, 
this value defaults to the number of allocated 
blocks in the cluster plus one half of the value cal- 
culated by the FREEBLK prompt. If the DELTHR parame- 
ter is specified as null and a value is specified for 
the DYN parameter, this value defaults to zero. 
Specif iy null unless data set usage indicates that 
tuning is required. 

The number of blocks to be assigned to (or added to) 
the free pool. When this parameter is used with oth- 
er free pool parameters, the free pool size is calcu- 
lated as specified by the FPOOL parameter, and the 
value specified for DYN is added to the number of 
blocks for the free pool. DYN can be specified with- 
out the other parameters and the free pool will be 
the number of blocks specified for DYN. 
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If a value is specified for the DYN parameter* other 
parameters assume the following defaults if speci- f 

f ied as null: v.- 



BASEREC 


a 


1 


FREEREC 


= 





FREEBLK 


a 





RSVBLK 


a 





RSVIX 


a 





DELTHR 


s 






FPOOL = 

The define (DF) comma n d sets the si?.e of the data set. There- 
fore, the BASEREC, FREEREC, FREEBLK, RSVBLK, RSVIX, FPOOL, and 
DYN parameters should be large enough to accommodate the maxi- 
mum number of records planned for the data set. 

To calculate the size of the data set for a given combination of 
parameters, use the SE command. 



W 
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$ IMAGE 



$IMAGE - DEFINE 4978^4979 FORMATTED SCREEN IMAGE 



$IMAGE defines formatted screen images for the 4978/4979 dis- 
play terminals, or for any terminal whose support includes the 
static screen functions. The images (formatted screens), 
which are defined in terms of protected and non-protected 
alphanumeric fields, can be saved in disk or diskette data 
sets, to be retrieved later by application programs for dis- 
play, or by this utility for modification. 

You must allocate the data set where the image will be stored 
before using $ I MAGE. Most logical screens require a data set of 
two records. There are two modes of interaction with the $ I M A G E 
programs command mode and edit mode. For retrieval informa- 
tion, refer to screen formatting in the System Gu i de . 



You can find an example using $IMAGE to format a static screen 
in the System Gu i de . For an aid in laying out the format of the 
screen to be defined, refer to the IBM 3270 Information Display 
System Layout Sheet, GX27-2951. 

Note ♦ A 2K-byte buffer is used withing $IMAGE to manipulate 
the screen being created. If the screen is greater than 2K 
bytes, unpr ed i cat ab 1 e results may occur. 



V y 



$IMAGE Commands 



$IMAGE is in command mode when loaded. When $IMAGE is in com- 
mand mode, you specify the function to be performed by entering 
an alphabetic code followed by a parameter list. You are 
prompted for each item that is not specified in advance and 
does not have a default value. 

The commands available under $IMAGE are listed below. To dis- 
play this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 
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AL - Allocate Data Set 

AL identifies a data set to be allocated. It returns a $DISKUT3 
return code that can be used by the JUMP command. 

Note: If an AL statement is coded between a PROGRAM and EXEC 
statement* the results may be unpredictable. 

Syntax 



AL name»volume size type 

Required: name» volume 

s i ze 

type 
Default: none 



f\ 



Operands Description 

name Defines the data set to be allocated 

volume Defines the volume on which the data set is to be 
a 1 located 

size Defines the size in blocks of the data set 

type Defines the type of data set as follows: 

D indicates data (default) 

P indicates program 

U indicates undefined 



AL Example 



AL 



TEMPDS,EDX003 25 D 
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DE - Delete Data Set 

DE identifies a data set to be deleted. 

Note: If a DE statement is coded between a PROGRAM and EXEC 
statement, the results may be unpredictable. 

Syntax 



DE 



name t vol ume 



Required: name, volume 
Default: none 



Operands Descr i pt i on 

name Defines the data set to be deleted 

volume Defines the volume from which the data set is to be 
deleted 

DE Example 






DE 



TEMPDS,EDX003 
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4966 Diskette Usage Considerations 



If you are using the 4966 diskette magazine unit for your 
dump/restore operation, you can use diskette magazines or an 
individual diskette slot. If you use an individual diskette 
slot, then all of the subsequent diskettes mounted must be 
placed in the same slot. If you use diskette magazines, you 
must have all of your diskettes in the correct sequence with no 
empty slots in the magazine. The first volume with the suffix 
00 must be in slot number 1 of the first magazine. You can use 
either or both of the diskette magazines, A and B. 



Data Set Specification 



If 5M0VEV0L is invoked with the $L command, you are prompted to 
enter the names of the data sets and volumes to be used. 

Figure 21 shows the parameter menu displayed when $M0VEV0L is 
invoked using the session manager. Enter the requested infor- 
mation and press ENTER. 



SSMM0308: SESSION MANAGER $M0VEV0L PARAMETER INPUT MENU- 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



DISK 



($$EDXLIB, VOLUME) ==> 



DISKETTE (NAME, VOLUME) ==> 



Figure 21. $M0VEV0L parameter input menu 
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Dump Procedure 



V.> 



The following steps are required to dump the 
direct access volume onto diskette. 



contents of a 



1. 



Set up a control diskette, 
a. Use $INITDSK tot 



1) 

2) 
3) 



Initialize the 
label that is 
SAVEOO) . 



control 
s u f f i x e d 



d i skette 
with 00 



w i th 
(for 



a vol ume 
example , 



Create a directory of at least 2 records. 

If the diskette is to be used to IPL another sys 
tern, reserve space for a nucleus of the appropri 
ate size and write the IPL text. 



b. Use $DISKUT1 to: 



1) 



2) 



Determine the directory size, 
volume to be dumped. 



i n records , of the 



Change volume to the control diskette (for exam- 
ple, SAVEOO) and allocate a control data set with 
the same name as the name, of the volume to be 
dumped. The member size of the control data set 
must be one record larger than the size of the 
directory of the volume being dumped. 



c. Use $C0PYUT1 to: 

1) Copy other data sets onto the control data set. For 
example, you may required $EDXNUC, the transient 
loader, or a copy of $M0VEV0L. 

Note : The first record in the control data set 
contains control information and up to 50 charac- 
ters of text describing the data being dumped. The 
remaining space stores a copy of the directory of 
the volume being dumped. 

2. Set up a series of data diskettes. For each data diskette: 

a. Use $INITDSK to: 

1) Create a volume label. The volume label of each 
diskette must have the same four-character prefix 
as the control diskette and a two-character suffix 
indicating the sequence number, for example, 






Cy 
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$TAPEUT1 - 
5719-UT4) 



TAPE MANAGEMENT (only available in Version 2, 






$TAPEUT1 performs several commonly used tape management func- 
tions. You can initialize tapes, allocate tape data sets, copy 
data sets or volumes to or from tape, copy tape to tape, print 
tape records, dump/restore disk devices, and test the tape 
transport hardware. 

$TAPEUT1 is invoked with the $ L command or primary option 3 of 
the session manager. Once invoked and prior to accepting com- 
mands, $TAPEUT1 displays the following information about the 
tapes defined to the system: 

TAPEID 

Density select i on (800, 1600, DUAL) 

Label type (SL, NL, BLP) 

Current density setting 

Online or offline 

Volume information (if an online SL tape) 

Device address 

Example: Loading $TAPEUT1 and its automatic display of the sys- 
tem tapes . 



> $L $TAPEUT1 

STAPEUTl 21P,ll: 11 :33, LP = 

TAPE01 DUAL SL 1600 OFFLINE 

DEVICE ADDRESS = 004C 

TAPE02 DUAL NL 1600 OFFLINE 

DEVICE ADDRESS = 004D 

COMMAND (?): 



0000 



Note : Error logging of tape errors 
System Guide . 



is available. Refer to the 
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$TAPEUT1 Commands 



The commands available under $TAPEUT1 are listed below. To dis- 
play this list at your terminal, enter a question mark in reply 
to the prompting message COMMAND (?):. 






J 



COMMAND (?): ? 

CD - COPY DATASET 

CT - CHANGE TAPE ATTRIBUTES 

DP - DUMP TAPE 

EN - END STAPEUT1 

EX - EXERCISE TAPE 

IT - INITIALIZE TAPE 

MT - MOVE TAPE 

RT - RESTORE DISK/VOL FROM TAPE 

ST - SAVE A DISK/VOL ON TAPE 

TA - ALLOCATE TAPE DATASET 

COMMAND (?): 



vy 



After the commands are displayed* you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example , CD) . 



y 
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Restore the image buffer of 
64 character set . 



a 4974 printer to the standard 



Assign a DEFINE key in a 4978 control store. 

Change the definition of one or more keys in a 4978 control 
store . 

Load a 4978 control store from a direct access data set 
or save a newly redefined 4978 control store into a 
direct access data set. 

Load a 4978 image store from a direct access data set or 
save a 4978 image store into a direct access data set. 
Refer to the description of the $ F N T utility program for a 
description of image store definition. 






You may wish to invoke these functions from a terminal other 
than the one you are using; therefore* you are requested to 
specify a terminal. If the selected terminal is not a 4974 or 
4978, you are notified and the command is rejected. 



4974 Support 



Use $TERMUT2 to restore the image buffer of a 4974 printer to 
the standard 64 character set. The 49 74 printer uses the 
Extended Binary Coded Decimal Interchange Code (EBCDIC), which 
includes 64 standard characters and five characters for inter- 
national use. The standard key definition can be changed by 
using the TERMCTRL instruction within your application program 
or the $FONT utility and the redefined character set is stored 
in the image buffer of the 4974. For detailed information on 
the 4974 printer, refer to the Bibliography for the 4974 Print- 
er manua 1 . 



4978 Support 

Use $TERMUT2 to make special character string assignments on 
the 4978 keyboard. The functional characteristics of a 4978 
keyboard are defined by data tables in the system-supplied data 
sets. These tables vary according to the particular keyboard 
used and are provided on an IBM diskette shipped with your key- 
board. The tables contained on the diskette are of two types: 



Control data 



Image data 
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Control data consists of scan code translation tables and a 
redefine table. Image data consists of a character image 
table. 

4978 displays have a control store and an image store* which 
are loaded from disk or diskette. At IPL, the system automat- 
ically loads all 4978s with the control store data set $4978CS0 
and the image store data set $4978150. These may be standard 
system-supplied data sets, or may be control/ image store data 
sets that you created and renamed S4978CS0 or $4978IS0. 

Key definitions can be changed* perhaps to be appropriate to a 
special key data application, and the redefined keyboard defi- 
nitions saved on disk. The keyboard definition can be reloaded 
later using STERMUT2 or by using the TERM CTRL instruction with- 
in your application. When the tables are altered, it is not 
necessary to alter the entire table. Your particular applica- 
tion may be enhanced through minor changes in key functions on 
a temporary or permanent basis. Use $ F N T to change the dis- 
play image of redefined keys. 

For detailed information on the 49 78 display station functions 
and the 4978 keyboards, refer to the Bibliography for 4978 Dis- 
play Station manuals. 

Data Set Names and Requirements 

Two special names are reserved by the system and used during 
initial program load time: 






y^y 1 



$4978IS0 - image store label 
S4978CS0 - control store label 



These data sets are automatically searched for and loaded to 
defined 49 78 display stations during the initialization phase 
at IPL time. After IPL, STERMUT2 can be used to load a control 
or image store from control/image data sets you have defined, 
or to read the control or image store in a display, and write to 
a data set you have allocated. 

For each control store or image store that you create and wish 
to save, STERMUT2 requires preallocated data sets. The size of 
the data sets is as follows: 

1. A 16-record (4096 bytes) data set for each control store 

2. An 8-record (2048 bytes) data for each image store 
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Naming conventions for image store and control store data sets 
follow the conventions of the Event Driven Executive: the 
label can be up to eight characters. 



$TERMUT2 Commands 

The commands available under $TERMUT2 are listed below. To 
display this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 



COMMAND (?): ? 

AD - ASSIGN DEFINE KEY 

C - CHANGE KEY DEFINITION 

EN - END PROGRAM 

LC - LOAD CONTROL STORE 

LI - LOAD IMAGE STORE 

RE - RESTORE 4974 TO STD. 64 

SC - SAVE CONTROL STORE 

SI - SAVE IMAGE STORE 

COMMAND (?): 



CHAR. SET 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example, AD ) * 
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AD - Assign a Define Key 

The AD command predefines a key that causes the 4978 attachment 
to enter define mode and enables you to assign a function or a 
series of functions to a specific key (for example* a PF key). 

Syntax 






AD 

Requ i red : 
Default: 



number terminal 

ALL 
none 



Operands Descr i pt i on 
number 



Hexadecimal number of the key assigned as the DEFINE 
key 



terminal The name of the terminal whose control store is being 
modified; * specifies the terminal that invoked 
$TERMUT2 



•%^y 



AD Example 

Assign a Define Key: 



COMMAND (?): AD 

ENTER SCAN CODE OF KEY TO BE ASSIGNED 

AS THE DEFINE KEY (HEX): 21 
ENTER TERMINAL NAME (CR OR * = THIS ONE): $SYSLOG 
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C - Change a Key Definition 

The C command changes the function ID, local character* or 
interrupt code of a key to another definition on the terminal 
spec i f i ed . 

Syntax 



terminal key id char interrupt 



Requ i red : ALL 
Default: none 



o 



Operands 
terminal 

key 
id 



Description 

The name of the terminal whose control store is 
being modified; * specifies the terminal that 
invoked $TERMUT2 

Defines the key (in hexadecimal) to be redefined 

Defines the new function of the key (in 
hexadec i ma 1 ) 



char 



Defines the EBCDIC code (in hexadecimal) used to 
print the character on the screen 



interrupt Defines the key (in hexadecimal) as an interrupt 
key or a character 
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C Example 

Change a Key Definition 






COMMAND 
ENTER 
ENTER 
ENTER 
ENTER 
ENTER 



(?) : C 

TERMINAL NAME (CR OR * = THIS ONE): $SYSLOG 

SCAN CODE OF THE KEY TO BE REDEFINED (HEX): 01 

NEW FUNCTIONED (HEX): 20 

NEW CHARACTER/FUNCTION CODE (HEX): 00 

NEW INTERRUPT CODE (HEX): 01 



ANOTHER KEY? N 



EN - End Program 

The EN command terminates the $TERMUT2 utility. 
Syntax 



EN 

Requ i red : 
Default : 



none 
none 



V_> 



Operands Description 
None 

EN Example 

Terminate $TERMUT2: 



COMMAND (?): EN 
$TERMUT2 ENDED 
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LC - Load a Control Store 

The LC command loads the control store data set into the termi- 
nal specified. 



Synt a x 



LC name> volume terminal 

Required: ALL 
Default: none 






Operands Description 

name Defines the name of the data set to be accessed 

volume Defines the name of the volume containing the data 
set 

terminal Defines the name of the terminal that loaded the data 
set; * specifies the terminal that invoked $TERMUT2 

LC Example 

Load a Control Store: 



COMMAND (?): LC 

FROM DATA SET ( NAME , VOLUME ) : $4978CS0, EDX002 
ENTER TERMINAL NAME (CR OR * •= THIS ONE): * 
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LI - Load an Image Store 

The LI command loads an image store (character image table) on 
the terminal specified. 

Syntax 






LI name>volume terminal 

Requ i red ' ALL 
Default : none 



Operands Descr i pt i on 

name Defines the name of the data to be accessed 

volume Defines the name of the volume containing the data 
set 

terminal Defines the name of the terminal that loaded the data 
set; * specifies the terminal that invoked $TERMUT2 

LI Example 

Load an Image Store: 



"\^ 



COMMAND (?): LI 

FROM DATA SET ( NAME , VOLUME ) : $4978ISO, EDX002 
ENTER TERMINAL NAME (CR OR * = THIS ONE): * 
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RE - Restore 4974 to Standard 64 Character Set 

The RE command restores the image buffer of a 4974 printer to 
the standard 64 character set. 

Syntax 



RE 



term i na 1 



Required: terminal 
Def au It : none 



Operands Descr i pt i on 

terminal Defines the device to be restored 

RE Example 

Restore 4974 to Standard 64 Character Sett 






COMMAND (?): RE 

ENTER TERMINAL NAME (CR OR * = THIS ONE): MPRINTER 
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SC - Save a Control Store 

The SC command allows you to save a redefined control store in 
the data set specified. 

Synt a x 



/f t\ 



SC name>volume terminal 

Requ i red : ALL 
Def au 1 t : none 



Operands Description 

name Defines the name of data set to be saved 

volume Define the name of volume where data set is to be 
saved 

terminal Defines the name of terminal issuing the save; * 
specifies the terminal that invoked $TERMUT2 



SC Example 

S a v e a Co nt ro 1 Store ' : 



X^r 



COMMAND (?): SC 

SAVE DATA SET ( NAME , VOLUME ) : $4978CS0 , EDX002 
ENTER TERMINAL NAME (CR OR * = THIS ONE): $SYSLOG 
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SI - Save an Image Store 

The SI command saves a redefined image store in the data set 
specified. 



Syntax 



SI name>volume terminal 

Requ i red : ALL 
Def au 1 t : none 






Operands Description 

name Defines the name of the data set being saved 

volume Defines the name of the volume where data set is to 
be saved 

terminal Defines the name of the terminal issuing the save; * 
specifies the terminal that invoked $TERMUT2 

SI Example 

Save an Image Store? 



COMMAND (?): SI 

SAVE DATA SET ( NAME , VOLUME ) : $4978IS0> EDX002 
ENTER TERMINAL NAME (CR OR *=THIS ONE): $SYSLOG 
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Procedure for Defining an Interrupt Key 

The 4978 hardware supports the DEFINE function, which allows 
keys to be defined with special character strings that have 
meaning to a particular application or job. In order to define 
a key with special characters, DEFINE mode must be entered. 
This is accomplished by pressing the DEFINE key on the 4978 
keyboard . 



i 



Assuming a standard 4978 keyboard is installed, the $4978CS0 
control store supports the keyboard in Figure 21.1. (The 
unshaded keys produce hardware interrupts.) As can be seen, a 
DEFINE key is not permanently designated. However, using the 
AD command of $TERMUT2, you may assign a key of your choice as 
the DEFINE key. In Figure 21.1, the key labeled A is being' 
assigned as the DEFINE key and the key labeled B is the rede- 
fined interrupt key. 


















K? 


E 

N 
T 
E 
R 


MCHSf 


Ofcl 


ft£#K 


HOME 


± 


BBSS* 






\__J? 



Figure 21.1 4978 Keyboard, RPQ D02056 



Figure 21.2 and Figure 21.3 are taken from the General 
Inf ormat i on manual for the 4978 keyboard (RPQ D02056). Similar 
charts are in the General Information manuals for whichever 
keyboard you have installed. 

In Figure 21.2, each key position is assigned a reference num- 
ber. Figure 21.3 is a copy of the first of three pages docu- 
mented in the General Information manual for this particular 
keyboard and lists the hex scan code, function ID code, local 
function code, and interrupt code that make up the control 
store information for each key. This page shows identifying 
numbers on the keys in Figure 21.2 corresponding to the key 
position numbers on the chart in Figure 21.3. 
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1 


3 


4 


6 


7 


9 


10 


12 


13 


15 


23 


25 


26 


28 


29 


31 


32 


34 


35 


37 



67 I 68 69 R 70 71 72 73 74 75 76 77 78 79 80 81 



88 II 89 II 90 I 91 II 92 I 93 I 94 II 95 II 96 97 II 98 II 99 II 100 101 102 103 



10 II 111 II 112 113 | 114 115 116 I 117 118 119 II 120 121 ff 122 123 



131 132 I! 133 I 134 H 135 136 137 138 139 140 141 142 143 I 145 



17 


' 19 


39 


41 


61 


63 


82 


83 


106 


104 


105 


125 


126 


127 


146 


147 


170 


168 


169 



20 


22 


42 


44 


64 




66"^ 


85 


86 


87 


107 


108 


109 


128 


129 


130 


149 


150 


151 


172 


173 



£*\ 

^^.y 



Figure 21.2 Keyboard Reference Assignments 
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Control Store Data 




Downshift - Unshifted 


Upshift Shifted 




K 

e 

y 
p 


Scan code 




K 

e 

V 

P 


Scan code 








Function ID code 




Function ID code 






Character/local function code 




Character/local function code 




o 
s 
i 
t 
i 
o 
n 










Key top 












Key top 










Interrupt code 


symbol 


s 
i 
t 
i 
o 
n 








Interrupt code 


svmbol 






Character image table 




Character image table 
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Row 
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3 
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5 


6 
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01 
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00 


01 


















i 


, 


1 
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3 


02 


20 


00 


02 






















3 
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03 
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6 
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7 
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7 
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9 


06 


20 


00 


06 




















ft 9 


86 
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00 
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10 


07 


20 


00 
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00 


07 
























12 


08 
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09 
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00 
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13 
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00 
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00 


OD 






















15 
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00 
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Figure 21.3 Control Store Data 



In Figure 21.1, assume you want to make the key at A the DEFINE 
key. In Figure 21,2, that key position has a reference of 66. 
When using the AD command, you are prompted for the scan code of 
the key to be assigned as the DEFINE key. On Figure 21.3, the 
scan code for key position 66 is hex 20. After the scan code 
and terminal have been entered, as follows: 



o 
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COMMAND (?): AD 

ENTER SCAN CODE OF THE KEY 

AS THE DEFINE KEY (HEX) : 

ENTER TERMINAL NAME (CR OR 



TO BE ASSIGNED 
20 

* = THIS ONE) : 



STERMUT2 reloads the control store of the display, with key 
position 66 assigned as the DEFINE key. 

You can now press the DEFINE key at A to enter DEFINE mode and 
screen indicator 2 on the display monitor will brighten to 
indicate DEFINE mode. The next key pressed after the DEFINE 
key is the key which will be redefined. In this example, the 
key to be redefined is interrupt key 22 (B). Now all key 
depressions, until the DEFINE key is again pressed, will be 
assigned to interrupt key 22. 






You can now enter the character string $L SEDIT1N EDITWORK and 
then press one of the two ENTER keys. The screen will remain 
blank. You then press the DEFINE key again, ending the redefi- 
nition of interrupt key 22, and take the 4978 out of DEFINE 
mode . 

The character string entered is a request to load the text 
editing utility program $ E D I T 1 N , along with the name of a text 
edit work data set, EDITWORK. 



Counting the pressing of the attention key required to get the 
> prompt, and the pressing the ENTER key following the load 
request, this line of text normally takes twenty-one key- 
strokes to enter the system. Now that interrupt key 22 has been 
redefined as this line of text, only three keystrokes are 
required: 

• the attention key, resulting in the > prompt 

• the interrupt key 22, which enters $L $EDIT1N EDITWORK 



the ENTER key, 
string. 



which was also part of the redefinition 



For normal terminal usage, an active DEFINE key is not desira- 
ble. If it is pressed inadvertently, altering of the control 
store will result. The C command is used to change key position 
66 back to its original control store configuration, using the 
chart in Figure 21.3 to supply the codes. 
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COMMAND (?): C 

ENTER TERMINAL NAME (CR OR * = THIS ONE): * 

ENTER SCAN CODE OF THE KEY TO BE REDEFINED (HEX) 

ENTER FUNCTION ID (HEX): 20 

ENTER CHARACTER/FUNCTION CODE (HEX): 00 

ENTER INTERRUPT CODE (HEX): 23 

ANOTHER KEY? N 



20 






At the conclusion of the C operation, the control store of your 
4 9 78 still has interrupt key 2 2 defined with the text editor 
load request character string, but with no DEFINE key desig- 
nated. The SC command reads the control store, and stores it in 
a 16 record data set name 4978EDIT, which must be preal located . 
Any time you desire a keyboard with interrupt key 22 designated 
as text editor load request, the LC command of $TERMUT2 can be 
used to load the control store from 4978EDIT. 



COMMAND (?): SC 

SAVE DATA SET ( NAME , VOLUME ) : 4978EDIT 
ENTER TERMINAL NAME (CR OR * = THIS ONE): K 

COMMAND (?): EN 

STERMUT2 ENDED AT 01:27:44 



V> y 



Note: If a volume is not specified, the data set is saved on 
the I PL vol uttie . 



c 
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$TERMUT3 



$TERMUT3 - SEND MESSAGE TO A TERMINAL 



( 



$TERMUT3 sends a single line message from your terminal to any 
other terminal defined in the system. One message line is sent 
at a time and you are prompted for the message, the terminal the 
message is to be send to , and if additional messages are to be 
sent. There are no commands, only prompting messages as fol- 
lows '• 



ENTER TERMINAL NAME: 

Label of the terminal to which message is to go. 

ENTER MESSAGE TO SEND 

Type in message and press the ENTER (CR) key. 

The message is transmitted to the destination terminal. 

ANOTHER LINE? 

Yes or No. 

If yes, you are prompted to enter another message line. 

ANOTHER TERMINAL? 

Yes or No. If yes, select another terminal and 

repeat the above process. 

SEND MESSAGE LATER ('ATTN SEND f )? 
Yes or No. If yes, the program remains loaded 
and inactive. Pressing the ATTN key and 
entering 'SEND' starts the above process again. 



V-V 
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Keep STERMUT3 Active* Send a Message Later 






ANOTHER LINE ? N 

ANOTHER TERMINAL ? N 

SEND MESSAGE LATER ( f ATTN SEND f ) ? Y 

> SEND 

ENTER TERMINAL NAME: TTY30 
ENTER MESSAGE TO SEND 
TTY30 - ARE YOU THERE 

ANOTHER LINE ? N 

ANOTHER TERMINAL ? N 

SEND MESSAGE LATER ('ATTN SEND 1 ) ? N 

STERMUT3 ENDED AT 01:42:15 
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STRAP - SAVE STORAGE ON ERROR CONDITION 

STRAP intercepts certain class interrupts and saves the con- 
ten t s ' o f hardware registers and processor storage on a disk or 
diskette data set. This utility helps you to diagnose system or 
application program problems. The companion utility* SDUMP, 
prepares a formatted display of the data saved by STRAP. 

STRAP must be executed before an expected failure so that the 
requested class interrupts can be intercepted when they occur. 
It can also be activated if a class interrupt such as a program 
check or machine check do not occur. 

Two methods are provided to accomplished forced traps: 

• ATTN: TRAPDUMP 



• The console interrupt button 

STRAP does not affect the execution of any program or operator 
command unless it is activated by a class interrupt such as a 
program check or a machine check* or by the operator. 

If the dump data set resides on a diskette and the diskette is 
mounted on a 4966, the diskette must be in slot 1. 



v„y 



j 
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Example 



> $L $TRAP 

DUMPDS(NAME, VOLUME) : DUMP,EDX003 
$TRAP 15Pyl2:l6:42, LP8F00 



Notes 
CI) 



*-* WARNING *-*-*-* WARNING *-*-*-* WARNING *-* 



TO 
TO 
TO 
TO 
DO 
IF 



AC 
DE 
FO 
EN 
NO 
TR 



TRAP 

TRAP 

SPECI 

INVAL 

PRIVI 

PROTE 

INVAL 

TRAP 

INVAL 

FLOAT 

STACK 

TRAP 

SAVE 



TIVATE 
ACTIVA 
RCE TR 
D $TRA 
T USE 
AP OCC 
ON MAC 
ON PRO 
FICATI 
ID STO 
LEGE V 
CT CHE 
ID FUN 
ON SOF 
ID FUN 
ING PO 
EXCEP 
ON CON 
FLOATI 



TRAP 
TE TR 
AP US 
P USE 
$C TO 
URS S 
HINE 
GRAM 
ON CH 
RAGE 
IOLAT 
CK? ( 
CTION 
T EXC 
CTION 
INT E 
TION? 
SOLE 
NG PO 



USE 
AP USE 

E 

END $ 
YSTEM 
CHECK? 
CHECK? 
ECK? ( 
ADDRES 
E? (Y/ 
Y/N) Y 
? (Y/N 
EPTION 
? (Y/N 
XCEPTI 

(Y/N) 
INTERR 
INT RE 



TRAPON 
TRAPOFF 
TRAPDUMP 
TRAPEND 



ATTN 

ATTN 

ATTN 

ATTN 
TRAP 

MUST BE IPLED 
(Y/N) Y 
(Y/N) Y 
Y/N) Y 
S? (Y/N) Y 
N) Y 

) Y 

? (Y/N) Y 

) Y 

ON? (Y/N) Y 

Y 
UPT? (Y/N) Y 
GS? (Y/N) Y 



TRAP SET OFF 
READY FOR ATTN? X 

> TRAPON 

TRAP SET ON 

> TRAPOFF 
TRAP SET OFF 



— X 



(2) 
(2) 
(2) 
(3) 
(3) 
(4) 
(5) 
(6) 



(7) 



(8) 
(9) 



(11) 
(12) 
(12) 



Notes i 
1. 



The STRAP data set must be as large as the storage used: for 
a 64K-byte system* it must be at least 256 records; for a 
128K-byte system at least 512 records. 



2. Trap initiation is via the attention handler. TRAPON acti- 
vates the trap facility but does not produce a storage 
dump. You must activate the trap facility (TRAPON) first; 
then specify TRAPDUMP to force a storage dump. If TRAPDUMP 
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is used, IPL to resume operations. 

3. $TRAP should not be cancelled using $C. Use TRAPEND. 

4 . During trap processing, all I/O activities are halted. All 
configured devices are reset. IPL to resume operations. 

5. A 'Y T response saves storage and hardware registers when 
any machine check (storage parity, CPU control or I/O error 
check ) occurs . 

6. A "Y" response prompts you for the type of program check to 
trap. Any combination of the five types can be selected. 

7. A 'Y f response prompts you for the type of soft exception 
to trap. Any combination can be selected. 

8. It may be desirable to save storage even though no hardware 
detectable error has occurred. This option can be used to 
cause a trap when the console interrupt button is pressed. 
(Programmer console must be installed on Series/1) 



X""^\ 



9. Respond with ' Y T only if the Series/1 has the floating 
point hardware installed; otherwise no trap will take 
place . 



10 



Specify T floating point exception" and 'save floating 
point regs' as * n f if you do not have floating point hard- 
ware installed. If you specify 'Y' erroneously, STRAP will 
attempt to trap the floating point registers and get an 
error which results in no dump to the data set. 

11. $TRAP initializes to a TRAPOFF state. Any time after this 
message you can activate trap using the STRAP attentiion 
commands. See notes 2-4. 

12. These are the TRAPON and TRAPOFF attention commands. 
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SVERIFY - INDEXED FILE VERIFICATION UTILITY 

SVERIFY checks the validity of an indexed file and prints con- 
trol block and free space information about the file on 
$SYSPRTR. 

This $VERIFY description contains the following topics: 



$VERIFY Functions 

Invoking $VERIFY 

SVERIFY Example 

Messages Printed by SVERIFY 

$VERIFY Storage Requirements 



c 



$VERIFY Functions 

With SVERIFY you can: 

• Verify that all pointers in an indexed file are valid and 
that the records are in ascending sequence by key. 

• Print a formatted File Control Block (FCB) listing, 
including the FCB Extension block. The FCB Extension block 
contains the original file definition parameters. 

Note: The FCB Extension block does not exist and file 
definition parameters are not saved in the FCB for 
indexed files defined prior to version 1.2 of the 
Indexed Access Method. 

• Print a report showing the distribution of free space in 
your data set to help determine if reorganization is 
needed . 
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Invoking $VERIFY 

$ V E R I F Y can be invoked from either a terminal or a program 
coded in Event Driven Language. You must supply the same input 
in either case. If you invoke $ V E R I F Y from a terminal* supply 
the input required in response to prompts. If you invoke $ V E R - 
IFY from a program* supply the input required as parameters 
passed to the program. 



$VERIFY Input 

This section describes the input required to execute $ V E R I F Y . 

NAME»VOLUME Data set and volume names for the indexed file to 
be processed . 



Opt i on 



The type of processing you want $VERIFY to do. The 
three options are: 

Y - The FCB and the FCB Extension blocks are for- 
matted and printed. The file is verified. A 
free space report is printed. 

N - The FCB and the FCB Extension blocks are for- 
matted and printed. The file is verified. No 
free space report is printed. 

F - The FCB and the FCB Extension blocks are for- 
matted and printed. The file is not verified. 
No free space report is printed. 



Invoking $VERIFY From a Terminal 
Load the SVERIFY program as follows: 



x__^*/ 



$L $VERIFY 



When $VERIFY begins execution* you are prompted for the parame- 



ters described previously, 
invocation from a terminal 
later in this chapter. 



A complete example of a $VERIFY 
is shown under "$VERIFY Example" 



Invoking $ V E R I F Y From a Program 
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$VERIFY can be invoked by EDL programs with the LOAD instruc- 
tion. The only required parameter is the address of a 16-byte 
area that contains: 



Hex 
Pi splacement 
Data set name 

Volume name 8 

Detail listing request E 

(Y, N, or F left-justified) 



Decimal 
Length ( Bytes ) 

8 

6 

2 



The following example shows the use of $VERIFY to verify a data 
set named IAMFILE in the volume EDX002. A file verification 
and free space report are requested. 



EXAMPLE 
START 



PARMLIST 
DSNAME 
VOLUME 
DETAIL 



PROGRAM 
EQU * 



START, PGMS=($VERIFY) 



LOAD $VERIFY, PARMLIST 
WAIT $VERIFY 



PROGSTOP 

EQU * 

DC CL8 T IAMFILE f 

DC CL6'EDX002' 

DC CL2'Y' 



WAIT FOR POST COMPLETE 



INDEXED DATA SET NAME 
VOLUME NAME 
PROCESSING OPTION 



ENDPROG 
END 



$VERIFY Example 

This section presents the input and output for an example run 
of $VERIFY, along with descriptions of the material presented. 
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SVERIFY is invoked from the terminal as follows: 



> $L $VERIFY 

INDEXED ACCESS METHOD FILE VERIFICATION PROGRAM ACTIVE 

(NAME, VOLUME) : XMPL1, EDX002 
DO YOU WANT DETAIL LISTING? (Y/N/F): Y 
VERIFICATION COMPLETE, ERROR(S) ENCOUNTERED 
$VERIFY ENDED 



In this example, the first line loads and executes $VERIFY. The 
second line is printed by the program to indicate that exe- 
cution has begun. In the third line, the program prompts for 
the data set name and volume of the indexed data set to be ref- 
erenced by the program. The reply indicates the the data set is 
XMPL1, located on volume EDX002. In the fourth line, the pro- 
gram prompts for the amount of detail to be provided as output. 
The response of Y indicates that maximum detail is to be pro- 
vided. As the program executes, it provides output to the 
printer, as shown in the example outputs that follow. Finally, 
messages are displayed to indicate the number of errors found 
and that the program has ended. 

FCB Report 

The first page of the example output from $VERIFY follows. 
This page is printed however the $ V E R I F Y option is specified. 



'K^y 



y 
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VERIFY REPORT. NAME = XMPL1 



FLAG1 



KEY L 

KEY D 

BLOCK 

RECOR 

INDEX 

RBN 

RBN 

RBN 

MAX 

MAX 

LOAD 

LOAD 

FLAG2 

VERSI 
DELET 
# OF 
RBN 
RBN 
LEVEL 



D 

ENGTH 
ISPLA 

LENG 
D LEN 

ENTR 
F HIG 
F LAS 
F FIR 

OF R 

OF E 
POINT 
POINT 

: I 

ON NU 
E THR 
AVAIL 
F 1ST 
F HIG 
OF H 



SHBL 
1 

CEME 
TH = 
GTH = 
Y LE 
H LE 
T DA 
ST D 
ECOR 
NTRI 
VAL 
VAL 
MDWR 
1 

MBER 
ESHO 
ABLE 
FRE 
H PH 
IGH 



TYPE 
1 



NT; 



NGTH = 

VEL IDX BLK IN USE= 
TA BLOCK IN USE= 
ATA BLOCK IN USE= 
DS PER DATA BLOCK= 
ES PER INDEX BLOCK= 
UE FOR A DATA BLOCK= 
UE FOR AN INDEX BLOCK; 



LD (RECORDS)= 

BLOCKS IN FREEPOOL 
E POOL BLOCK= 
YSICAL IX BLOCK= 
INDEX BLOCK IN USE= 



VOLUME = EDX002 



15 



512 

124 

20 

2 

108 

8 

4 

24 

1 

1 



1 .2 

2 

30 

124 
2 
3 



This page of the example report is interpreted as follows: 

The first line shows the data set name and volume. 

FLAGU These two lines show the significant bits of the first 
flag byte in the FCB. The first of the pair of lines are a 
heading, and the second the bit values (where 1 indicates 
the bit is set* indicates it is not set). The headings 
are defined as follows! 

DSHBL Data set has been loaded flag. This flag is set 
when any record has been successfully loaded into 
the data set in load mode. 

TYPE This flag indicates whether the indexed data set 
was created with the Realtime Programming System 
Indexed Access Method PRPQ (bit=Q) or either the 
Event Driven Executive or Realtime Programming 
System Indexed Access Method Program Product 
(bit=l) . 
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KEY LENGTH Shows the length of the key in bytes. 

KEY DISPLACEMENT Shows the byte displacement of the key from 
the start of the record. 

BLOCK LENGTH Shows the byte length of blocks in the file. 

RECORD LENGTH: Shows the byte length of records in the file. 

INDEX ENTRY LENGTH: Shows the number of bytes in each index 
entry. This length should be the key length plus 4 , 
rounded up to a multiple of two bytes. 

RBN OF HIGH LEVEL IDX BLK IN USE: Shows which index block is to 
be used as the starting point when the index is to be 
searched . 

RBN OF LAST DATA BLOCK IN USE: Points to the last logical data 
block in the data set. 

RBN OF FIRST DATA BLOCK IN USE: Points to the first logical 
data block in the data set. It is used as the starting 
point when a sequential read operation is begun with no 
key specified. 

MAX 8 OF RECORDS PER DATA BLOCK*. Shows how many data records 
can be contained in a data block. 

MAX 8 ENTRIES PER INDEX BLOCK: Shows how many index entries can 
be contained in an index block. 

LOAD POINT VALUE FOR A DATA BLOCK: The number of records that 
can be placed in each data block while in load mode. This 
value is calculated at file definition time to provide 
the requested number of free records. 

LOAD POINT VALUE FOR AN INDEX BLOCK*. The number of data blocks 
in each cluster to be used while in load mode. This value 
is calculated at file definition time to provide the 
space requested by the RSVBLK, RSVIX and FREEBLK parame- 
ters. 



■^ 



FLAG2: Another byte of flags described by a pair of lines: a 
heading line followed by a data line. The heading has the 
following meaning: 

IMDWR Immediate write back flag. If set (1), this flag 
indicates that the immediate write back option was 
specified when the indexed data set was defined. 



(f 
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VERSION NUMBER! Shows the version number and modification lev- 
el of the Indexed Access Method that was used to define 
the indexed data set. 

DELETE THRESHOLD (RECORDS): Indicates the number of data 
blocks to retain in each cluster as records are deleted 
and blocks become empty. This value is calculated when 
the file is defined and is based on the DELTHR parameter. 

8 OF AVAILABLE BLOCKS IN FREEPOOL: The number of available 
blocks in the free pool. This count is updated as blocks 
are taken from or returned to the free pool. 

RBN OF 1ST FREE POOL BLOCK: Points to the last block which was 
put in the free pool (which is the next block to be taken 
from the free pool). 

RBN OF HIGH PHYSICAL IX BLOCK: Points to the physical top of 
the index. In some cases (if the file has not been com- 
pletely loaded), this RBN might not agree with the RBN OF 
HIGH LEVEL IDX BLK IN USE. If it does not agree, then the 
data set is structured with index blocks that are not yet 
needed because the file does not contain enough records. 

LEVEL OF HIGH INDEX BLOCK IN USE: Indicates how many levels of 
the index are currently in use. This field was not used 
prior to version 1.2 of the Indexed Access Method. 

FCB Extension Report 

The second page of the example output from $VERIFY follows. 
This page is printed however the $VERIFY option is specified if 
the file was defined with version 1.2 of the Indexed Access 
Method or a later release. 

This information is obtained from the FCB Extension block and 
shows the parameters that were specified when the file was 
defined. Some information (BLKSIZE, RECSIZE, KEYSIZE, KEYPOS) 
is duplicated on the FCB and FCB Extension report because it is 
contained in both control blocks. The values should correspond 
with each other. The word NULL for the value of a parameter 
indicates that the value was not specified when the file was 
defined (that is, it was allowed to default). 
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VERIFY REPORT. NAME = XMPL1 



VOLUME 



EDX002 



DATASET WAS CREATED WITH THESE IDEF PARAMETERS 



BASEREC= 

BLKSIZE= 

RECSIZE= 

KEYSIZE= 

KEYPOS= 

FREEREC= 

FREEBLK= 

RSVBLK= 

RSVIX= 

FPOOL= 

DELTHR= 

DYN = 



$2 

512 

124 

15 



3 

3 

91 

66 

3 

7 

NULL 



Note? The IDEF parameters are the file definition parame- 
ters that were specified on the SE command of the $IAMUT1 
utility when the file was defined. 

Free Space Report 

A free space report of the example output from SVERIFY fol- 
lows. The free space report is printed only if the $ V E R I F Y 
option is specified as Y. 



s_ 



,0\ 
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VERIFY 


REPORT 


. NAME = XMPL1 , 


VOLUME = 


: EDX002 








TOTAL 


USED 


UNUSED 


RESERVE 


FREE 


AVAILABLE 


RBN 


LVL 


ENTRIES ENTRIES 


ENTRIES 


ENTRIES 


BLOCKS 


RECORD SLOTS 


2 


3 


24 


4 





20 








3 


2 


24 


8 





16 








4 


2 


24 


8 





16 








5 


2 


24 


8 





16 








6 


2 


24 


11 





13 








7 




24 







22 




8 


10 




24 







22 




8 


13 




24 







22 




8 


16 




24 







22 




8 


19 




24 







22 




8 


22 




24 







22 




8 


25 




24 







22 




8 


28 




24 







22 




8 


31 




24 







22 




8 


34 




24 







22 




8 


37 




24 







22 




8 


40 




24 







22 




8 


43 




24 







22 




8 


46 




24 







22 




8 


49 




24 







22 




8 


52 




24 







22 




8 


55 




2 4 







22 




8 


58 




24 







22 




8 


61 




24 







22 




8 


64 




24 







22 




8 


67 




24 







22 




8 


70 




24 







22 




8 


73 




24 







22 




8 


76 




24 







22 




8 


79 




24 







22 




8 


82 




24 







22 




8 


85 




24 







22 




8 


88 




24 







22 




8 


91 




24 







22 




8 


94 




24 







22 




8 


97 




24 







22 




8 


25 




24 


6 





18 





12 


26 




24 


5 





19 





7 


47 




24 


13 





11 





21 


VERIFICATION 


COMPLETE, 





ERROR(S) 


ENCOUNTERED 
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In this report* each printed line represents an index block. 
The columns have the following meanings: 

RBN The relative block number within the indexed data 
set* based on the block size specified when the file 
was defined. The first block in the data set is rela- 
tive block number zero. 

LVL The level of the index block analyzed. Lowest level 
(PIXB) is 1, second level (SIXB) is 2, etc. 

TOTAL ENTRIES The maximum number of index entries that can 
fit in an index block. 

USED ENTRIES The number of entries used in this index block. 

UNUSED ENTRIES The number of entries in the index block 
which are neither used nor reserved. 



RESERVE ENTRIES The number of reserve entries in this index 
block. This number represents the number of new index 
blocks that can be obtained from the free pool for 
creation of new blocks* provided there are enough 
blocks remaining in the free pool. 



^ 



FREE BLOCKS The number of free blocks associated with this 
i ndex b lock . 

AVAILABLE RECORD SLOTS The maximum number of records that 
can be inserted into this cluster without obtaining 
blocks from the free pool. 
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$VERIFY Messages 

As $ V E R I F Y executes* any errors encountered result in an 
error message being written describing the type of error and 
where the error occurred. 



File Error Messages 

The following identify messages which indicate that the 
indexed data set contains errors: 

# BLOCKS IN FREEPOOL CHAIN DOES NOT MATCH FREE POOL 
COUNT IN FCB. 

BLOCK OUT OF SEQUENCE. RBN . 

HIGH KEY IN RBN DOES NOT MATCH IX ENTRY IN RBN 



POINTERS IN HEADER OF HIGH INDX BLK ARE NOT ZERO. 

RBN CONTAINS INVALID UPWARD POINTER. 

RBN 

RBN 



CONTAINS INVALID BACKWARD POINTER. 
CONTAINS INVALID FORWARD POINTER. 



RBN 



IS IN FREEPOOL CHAIN, BUT IS NOT A VALID 



FREEPOOL BLOCK. 



RBN 



CONTAINS INVALID BACKWARD POINTER . TASK TER- 



MINATED. 

RECORD OUT OF SEQUENCE NEAR RBN 



If any of these messages are printed, the indexed file has 
at least one error. 

Possible sources of the error include: 

• The file is not an indexed data set 

• Data in the file has been inadvertently destroyed 

• The Indexed Access Method has a program error 
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$VERIFY Storage Requirements 

$ V E R I F Y has two types of storage requirements.* 

♦ Storage for the $VERIFY and $DISKUT3 code 

• Storage for work space in verifying the file 

The $VERIFY utility code requires approximately 9K bytes of 
storage. In addition to this, $DISKUT3 (which is invoked to 
open the indexed file) requires 4 K bytes of dynamic storage. 
The space for $DISKUT3 must be available in the partition into 
which $VERIFY is loaded . 

Working storage space is also needed (unless the SVERIFY option 
is specified as F). The size of this storage required varies, 
depending on the maximum number of blocks at the SIXB level and 
the block size of the file. 

Using Default Working Storage Requirements 

The default working storage specification is 8K bytes. For a 
file with a block size of 256, this default is sufficient to 
handle up to 1920 blocks at the SIXB level. The larger the 
block size of the file, the fewer the maximum number of SIXB f s 
that can be processed. 

The following formula can be used to calculate the maximum num- 
ber of blocks at the SIXB level that $ V E R I F Y can process, given 
the block size of the indexed data set* 



NS = (8192 



(2 * BLKSIZE) ) / 4 



NS is the number of blocks at the SIXB level 
BLKSIZE is the block size of the indexed data set 
Modifying Working Storage Requirements 

The default working storage allocation is intended to satisfy 
the requirements of most indexed files. It may be necessary or 
desirable to modify the amount of working storage space avail- 
able to SVERIFY. 



The following formula can be used to calculate the amount of 
working storage required to process a file with a given block 
size and number of blocks at the SIXB level. 
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DS = (4 * NS) + (2 * BLKSIZE) 



Where : 

DS is the amount of dynamic storage required 

NS is the number of blocks at the SIXB level 

BLKSIZE is block size of the indexed data set 



The number of SIXB's in 
the free space report. 



a file can be determined by examining 



You can override the default working storage size at load time 
(if loaded by a program)* or with the SS command of the $DISKUT2 
utility. 

Summary 






$VERIFY requires 13K bytes plus a variable amount of working 
storage which defaults to 8K bytes. Increase the working stor- 
age size if $VERIFY runs out of space during execution. 
Decrease the working storage size if the number of SIXB's is 
significantly less than that supported by the default working 
storage allocation (1920 with a block size of 256) and space is 
at a prem i urn . 
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$UPDATE 



Convert and R en am e N ew Output Program if an Output Program 
Already exis ts : The existing output data set is undisturbed and 
a new data set (type PGM) of the proper size and with the new 
name is allocated. 



COMMAND (?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TESTPROG 
TESTPROG REPLACE? N 
RENAME? Y 

NEW PGM NAME: TSTPRG 
TSTPRG STORED 

COMMAND (?): 



End $UPDATE 



COMMAND (?): EN 

SUPDATE ENDED AT 11:39:34 
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Invoking $UPDATE 



Vy' 



Inv oking $UPDATE Using $JOBUTIL 



When $ UPDATE is invoked as part of a batch job under the control 
of $JOBUTIL» certain restrictions apply to its operation. In 
this mode* the command is assumed to be RP. The Rename function 
is not supported; however* the Replace function is. Refer to 
the preceding examples for a description of Rename and Replace. 



In batch mode* $UPDATE terminates its execution after perform- 
ing one RP command. A completion code is set by $ U P D A T E depend- 
ing upon the success or failure of the requested operation, 
T'h is code can be tested by the JUMP command of $JOBUTIL. The 
$UPDATE completion codes are described in Chapter 6, Messages 
and Codes. 



When $JOBUTIL is used to invoke $ U P D A T E , the information 
required by $ UPDATE must be passed to it by means of the PARM 
command of $JOBUTIL. The required information consists of J 



1. The name of the device to receive the printed output 
resulting from $ U P D A T E execution 



\_y 



2. The name, volume of the data set containing the input object 
modu le 

3. The name, volume of the data set to contain the output 
loadable program 

4. An optional parameter YES if the output module is to 
replace an existing module of the same name, volume 

The volume names of the data sets must be given unless they 
reside on the IPL volume. 

The first three items of information are required and must be 
given in the order described. At least one blank must occur 
between each of these four items in the PARM command. 

An example of invoking $UPDATE via SJOBUTIL commands follows: 



L.y 
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Messages and Codes 



CHAPTER 6. MESSAGES AND CODES 



This chapter describes messages and codes generated by the 
Event Driven Executive. The information is presented in two 
sections; the first contains messages information and the sec- 
ond contains the completion, return, and post codes. 
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MESSAGES 

This section lists and describes messages generated while? 

• Initializing your system 

• Executing a utility 

• Executing a program 

The messages are documented in alphabetic order according to 
the message text. Messages that begin with a variable are doc- 
umented at the end of the alphabetic listing under X. 

Immediately following the alphabetic listing of messages, the 
program check error message, the system program check error 
message, and the processor status word (PSW) are documented. 

Message Documentation 



The documentation for each message includes the following. 

Message Text: The message text is presented in boldface type, 
as it will be printed or displayed. Lowercase variable fields 
will be replaced with the correct data when the message is 
i ssued . 

Issued By: The issued by text identifies the function that 
issued the message. 

Explanation: The explanation identifies all the variable 
fields and describes any information supplied by the program. 
The conditions under which the message is issued are noted. 

System Action: The system action describes the system reaction 
to the condition that caused the message to be issued. 

Response: The response explains how you are to reply to the 
message or what, if any, corrective actions are required to 
help you resume. 

Return Codes: The message text sometimes includes a return 
code, which is generated by the Event Driven Executive. The 
name of the function that generated the return code is speci- 
fied in the "Issued By" portion of the message documentation. 



\^ 
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Messages 



To determine the error condition* get the name of the function 
involved and go to the Codes section of this chapter* which 
lists the return codes by function. 



$DISKUT1 LOAD ERROR. RETURN CODE = XXX . 

Issued By: $IAMUT1 

Explanation : $IAMUT1 attempted to load the $DISKUT1 ut'ility 
program and load failed. 

System Action: Prompts for next command. 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 



$DISKUT3 LOAD ERROR 

Exp lanat i on : 

$VERIFY was unable to load $DISKUT3. 

System Action: 

An abend message follows with the return code from LOAD con- 
tained in it. SVERIFY terminates. 

Response ? 

Examine the LOAD return code to determine the problem. Refer 
to the description of the LOAD return codes. 

If the LOAD return code indicates insufficient storage* 
rerun $ V E R I F Y in a partition with more storage available or 
rerun it when more space is available in the current parti- 
tion. 

Otherwise* correct the problem and retry. 
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$LOG - *M* INSUFFICIENT BUFFER FOR LOG RATE *** 

Issued By: SLOG Utility 

Explanation: The error has become full. 

System Action: The $LOG utility is terminated. 

Response : Increase the buffer size and restart the $ L G util 
i ty . 



$RMU ERROR 1 - INSUFFICIENT BUFFER. SIZE: nnnn 

Issued By: Remote Management Utility 

Explanation: The size of the buffer defined for use by the 
utility is less than the 512 byte minimum. The default 1024 
byte buffer size has been modified incorrectly. 

System Action: The execution of the program terminates. 

Response : Check the buffer size and respecify a valid size 
and restart the program. 



^„^ 



$RMU ERROR 2 - COMMUNICATIONS OPEN FAILED, RETURN CODE: xxx 

Issued By : Remote Management Utility 

Exp lanat i on : The OPEN of the BSC communication line failed. 

System Action: The execution of the program is terminated. 

Response : Check the BSC return code to find the cause of the 
problem and take the appropriate action. 



*^r 
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$RMU ERROR 3 - COMMUNICATIONS CLOSE FAILED, RETURN CODE*. XXX 

Issued By ' Remote Management Utility 

Explanation: The CLOSE of the BSC communication line failed. 

System Action* The execution of the program terminates. 

Response : Check the BSC return code to find the cause of the 
problem and take the appropriate action. 






$RMU ERROR 4 - COMMUNICATIONS I/O ERROR. 
I/O FUNCTION: aaaaaa 
RETURN CODE: xxx 

Issued By : Remote Management Utility 

Explanation: A communication error has been detected by the 
ut i 1 i t y . 

System Action: This message appears whenever BSCAM encount- 
ers an I/O error. If the error is either a time-out (return 
code 10) or a sequence error (return code 12)> the Remote 
Management Utility terminates the current function and waits 
for the next request from the host. Otherwise* the Remote 
Management Utility terminates after reporting the I/O error. 

Response: The I/O function (aaaaaa) will indicate the type of 
request, and is one of the following: 

READ INITIAL 
READ CONTINUE 
WRITE EOT 
WRITE INITIAL 
WRITE EOT (ABORT) 
WRITE CONTINUE 

Check the BSC return code to find the cause of the problem and 
take the appropriate action. 



Chapter 6. Messages and Codes 425 



Page of SC34-03 13-2 

As updated February 13, 1981 

By TNL SN34-0684 



Messages 






SRMU ERROR 5 - LOAD OVERLAY FAILED, RETURN CODE: xxx 
OVERLAY NUMBER: mmmm 

Issued By : Remote Management Utility 

Explanation' The utility attempted to load an overlay pro- 
gram via a LOAD instruction, and the LOAD failed. 

System Act i on : The execution of the program terminates. 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 



SRMU ERROR 6 - OVERLAY FUNCTION MISSING. FUNCTION: nnnn 
OVERLAY NUMBER: mmmm 

Issued By : Remote Management Utility 

Exp 1 anat i on : The utility's function table defined a function 
as being contained within an overlay, but is was not. 

System Action: The execution of the program is terminated. 

Response : Check to see that the user written function is 
added properly to the function table. Correct the problem 
and restart the program. 



STRAP MUST BE IN PARTITION 81. 
STRAP TERMINATED 

Issued By: STRAP Utility 

Explanation: STRAP was loaded into a partition other than 
partition 1. It must be loaded into partition 1. 

System Act i on : The $TRAP utility is terminated. 

Response : Load STRAP into partition 1 and restart the STRAP 
utility. 



c 
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$VERIFY ABENDED, RTCODE = 

Explanation? 

$ V E R I F Y encountered an error such that it was unable to con- 
tinue process i ng . 

System Action? 

$VERIFY terminates. 

Response : 

Check the previous message printed to determine the general 
problem area. Examine the return code in this message to 
determine the problem. Refer to the description of the 
return codes. 

Correct the problem and retry. 



BUFFER SMALLER THAN INPUT OR OUTPUT RECORD. INCREASE BUFFER 
SIZE BEFORE REATTEMPTING OPERATION 

Issued By: $IAMUT1 

Explanation: Insufficient program storage to contain an 
input or output record. 

System Action: Command terminates. 

Response : Increase the dynamic program size using the SS com- 
mand of the $DISKUT2 utility. The buffer size must be large 
enough to contain the entire input and /or output record 
(whichever is larger). 



Chapter 6. Messages and Codes 427 



Page of SC34-03 13-2 

As updated February 13, 1981 

Bv TNL SN34-0684 



Messages 



\_y 



CONNECT TO MTM? 

Issued By: Multiple Terminal Manager 

Explanation: This message is written to determine whether to 
connect the terminal t\p $ M T M or some other program. 

System Action: Accepts operator response. 

Response : Enter 'Y' to connect the terminal to a Multiple 
Terminal Manager named $MTM. Enter 'N T to connect the termi- 
nal to a Multiple 



CONNECTED TO MULTIPLE TERMINAL MANAGER 

Issued By: Multiple Terminal Manager 

Explanation: This message is written to a non-full-screen 
type terminal when it is connected to the Multiple Terminal 
Manager . 

System Action: None . 

Response : None needed. 



DEVICE AT ADDRESS 0002 UNUSABLE 

Issued By : Diskette Initialization 

Explanation: A 4964 diskette device is marked unusable and 
the status message is printed next if I/O operations to the 
device fail. 

System Action: The initialization is terminated. 

Response : Check to see what problems might exist with the 
diskette. Correct the problem and restart the initializa- 
tion. 
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DEVICE AT ADDRESS 0003 UNUSABLE 

Issued By : Disk Initialization 

Explanation: A 4 9 6 2 or 4963 disk is marked unusable and the 
status message is printed next if I/O operations to the 
device fail. 

System Action: The initialization is terminated. 

Response : Check to see what problems might exist with the 
disk. Correct the problem and restart the initialization. 



DEVICE AT ADDRESS 22 UNUSABLE 

Issued By: Diskette Initialization 

Explanation: A 4966 is searched in slot 1» slot 1 of magazine 
A and slot 1 of magazine B. If a diskette is found in any one 
of these slots, searching continues until an empty slot is 
found. If no diskettes in the 4966 diskette device can be 
accessed the device is marked unusable and the following sta- 
tus message is printed. 

System Action: The initialization is terminated. 

Response : Insert a new diskette in the 4966 diskette device 
and restart the initialization. 



DEVICE TYPE INVALID 

Issued By: Multiple Terminal Manager 

Ex planation: The device type specified for the TERMINAL file 
record listed immediately before this message is invalid or 
TYPE=3101 and no 3101 support was included. 

System Action: The terminal is not connected. 

Response : Correct the TERMINAL record or rebuild the Multi- 
ple Terminal Manager with the 3101 support. Stop and restart 
the manager . 
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DISCONNECTED FROM xxxxxxxx 

Issued By : Multiple Terminal Manager 

Explanation? The terminal is disconnected from the Multiple 
Terminal Manager named xxxxxxxx. 

System Action: None . 

Response : Reconnect the terminal when desired. 

DISK ERROR DURING INITIALIZATION, RC=xxx 

Issued By: Multiple Terminal Manager 

Explanation: A disk error occurred while reading the SCRNS 
volume directory, the PRGRMS volume directory, the TERMINAL 
data set, or an error occurred while writing to the MTMSTORE 
data set . 

System Action: Aborts initialization. 

Response: Check the Multiple Terminal Manager return code to 
find the cause of the problem and take the appropriate 
action. 



X. J 



DISK READ ERROR 

Issued By : Multiple Terminal Manager 

Explanation: An internal Multiple Terminal Manager disk read 
error has occurred and results may be unpredictable. 

System Action: Results are unpredictable. 

Response : Determine the cause of the error and retry opera- 
tion. 



r 
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dsname ON dsvol DOES NOT CONTAIN $TRAP OUTPUT. $DUMP TERMI- 
NATED 

Issued By: $DUMP Utility 

Exp 1 anat i on : The data on the data set to be dumped is not the 
output of STRAP. 

System Action? The $DUMP utility is terminated. 

Response ? Enter the valid dsname and dsvol for that which is 
the output of STRAP and restart the $DUMP utility. 






dsname ON dsvol IS ONLY xxx RECORDS. MINIMUM SIZE IS yyy 
RECORDS. 
$TRAP TERMINATED 

Issued By: STRAP Utility 

Explanation: The data set assigned to STRAP is not large 
enough to contain the amount of storage being saved. 

System Action: The STRAP utility is terminated. 

Response : Increase the size of the data set assigned to STRAP 
to a minimum of yyy records and restart the STRAP utility. 



Chapter 6. Messages and Codes 431 



Page of SC34-03 13-2 

As updated February 13, 1981 

By TNL SN34-0684 



lassagas 



/T> 



DSOPEN ERROR. RETURN CODE = xxx. RETRY? 

Issued By; SIAMUT1 

Explanation: An attempt to open the specified data set failed 
due to one of the following reasons: 

Data set not found on specified volume 

Inval i d IODA 

Invalid VOLSER 

Library not found 

I/O error occurred 

No VTOC 

DSNAME = $$ 

System Action: Allows user to respecify DSNAME, VOLUME if 
retry = Y. If retry = H, command terminates. 

Response : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 

DUMP RANGE INVALID VALID RANGE IS xxxx TO yyyy 

Issued By: $DUMP Utility 

Explanat i on : An invalid starting or ending storage address 
was entered during a partial storage dump. 

System Action: The $DUMP utility is terminated. 

Response : Enter a valid storage address in the range xxxx to 
yyyy and restart the $DUMP utility. 



c 
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EDX SYSTEM INITIALIZATION COMPLETE 

I ssued By : System 

Explanation: When the system is initialized, this message is 
printed. 

System Action: None. 

Response : None. 



^■"N 
^u**/ 



ENTER NAME OF MULTIPLE TERMINAL MANAGER PROGRAM 

Issued By: Multiple Terminal Manager 

Explanation: This message is printed by the $ R E C N utility. 
It results from an entry of 'N' to a prompting message asking 
if the terminal is to be connected to $MTM. 

System Action: Accepts operator response. 

R esponse : Enter the name of the program to which you want to 
connect the terminal. 



ERROR ENCOUNTERED DURING CLOSE OF INDEXED ACCESS METHOD 
(dddddddd, vvvvvv) , ERROR CODE=(xxx) 

Issued By: Multiple Terminal Manager 

Explanation: An error occurred during AUTOCLOSE of an 
Indexed Access Method data set. 

dddddddd is the data set name. 

vvvvvv is the volume name. 

System Action: None. 

Response : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 
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ERROR OCCURRED DURING DISK READ 

Exp lanat i on : 

$VERIFY attempted to read from the indexed data set and an 
unrecoverable disk read error occurred. 

System Action: 

An abend message follows with the return code from READ con- 
tained in it. SVERIFY terminates. 

Response : 

Examine the READ return code to determine the problem. Refer 
to the description of the READ return codes. 

Correct the problem and retry. 



ERROR ENCOUNTERED USING $DISKUT3 FOR OPEN 

Explanation: 

$VERIFY attempted to open the indexed data set and a $DISKUT3 
error occurred. 

System Action: 

An abend message follows with the return code from $DISKUT3 
contained in it. $ V E R I F Y terminates. 

Response : 

Examine the $DISKUT3 return code to determine the problem. 
Refer to the description of the $DISKUT3 return codes. 

Correct the problem and retry. 



c 
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HK* EVENT DRIVEN EXECUTIVE *** 

Issued By : IPL Operation 

Exp lanat i on : After $SYSLOG terminal initialization this mes 
sage appears on the SSYSLOG terminal. 

System Action: None. 

Response : None. 



I/O ERROR INITIALIZATION FIXED HEAD DEV, DISK RETURN CODE= XXX 
IN THE TWO RECORDS STARTING WITH RECORD XXX 

Issued By : Disk Initialization 

Exp lanat i on : An error was encountered during fixed head 
initialization starting with record xxx. 

System Action: The initialization is terminated. 

Response : Check the Disk return code to find the cause of the 
problem and take the appropriate action. 



INITIALIZATION ERROR 

Issued By : Multiple Terminal Manager 

Explanation: Initialization was unsuccessful. This message 
is written to the terminal that loaded the Multiple Terminal 
Manager. Additional messages are printed on the Multiple 
Terminal Manager log device. 

System Action: Multiple Terminal Manager terminates. 

Response : Determine the cause of the error and take correc- 
tive action. 
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INVALID COMMAND 

Issued By: SIAMUT1 

Exp lanat i on : An invalid command was entered by the user. 

System Act i on ' Reprompts for command. 

Response: Enter a question mark (?) to obtain a list of valid 
commands and try again. 

INVALID PROGRAM NAME 

Issued By? Multiple Terminal Manager 

Exp 1 ana t i on : The name of the program requested from the pri- 
mary menu was not found in the Multiple Terminal Manager pro- 
gram table or invalid parameters were supplied on a 
DISCONNECT command. 

System Action: The requested function is not performed. 

Response : Correct the program name or parameters and retry 
the request . 

INVALID SIGNON CHARACTER 

Issued By : Multiple Terminal Manager 

Explanation: The SIGNON specification for the TERMINAL file 
record listed immediately before this message is not "Y" or 
"N". 

System Action: The terminal is not connected. 

Response : Correct the TERMINAL record. Stop and restart the 
manager , 



zf~ 
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INVALID TERMINAL 

Issued By : Multiple Terminal Manager 

Explanation: The terminal name entered with a DISCONNECT 
command is not a Multiple Terminal Manager terminal. 

System Act i on : The terminal is not disconnected. 

Response : Retry specifying a valid terminal name. 






KEY OF INPUT REC xxxxxx IS DUPLICATE OR OUT OF SEQUENCE. OMIT 
THE RECORD AND CONTINUE? 

Issued By: $IAMUT1 

Exp lanat i on : A duplicate key exists in the input sequential 
data set and could not be written to indexed data set. 

System Act i on : If reply = Y, the next record will be read from 
input data set and processing continues. If reply = N> com- 
mand termi nates . 

Response : Make sure the input data set contains the proper 
data. Check the KEYSIZE and KEYPOS parameters used to define 
the indexed data set against the input data set records. 
Make sure the data in the input data set is in the proper 
sequence. Redefine and reload data set if necessary. 



LOAD ERROR RC=xxx 

Issued By: Multiple Terminal Manager 

Explanat i on : A load failure occurred. 

System Act i on : The terminal is not available to the Multiple 
Terminal Manager. 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 
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LOAD FOR SERVER xxxxxxxx FAILED* RC=xxx 

Issued By: Multiple Terminal Manager 

E xplanat i on : A load failure occurred during initialization 
for the server for terminal xxxxxxxx. 

System Act i on : The terminal is not available to the & m . . 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 



MENUNAME INVALID 

Iss ued Bv : Multiple Terminal Manager 

Explanation: The primary menu name specified for the TERMI- 
NAL file record listed immediately before this message is 
invalid. 

System Action? The terminal is not connected. 

Response: Correct the TERMINAL record. Stop and restart the 
manager , 



N^ ^ 



MULTIPLE TERMINAL MANAGER SYSTEM FAILURE 

Issued By : Multiple Terminal Manager 

Explanation: The Multiple Terminal Manager task error exit 
routine has been entered due to a machine or program error. 

The PSW and LSB at the time of failure has been saved at a 
displacement of X T 1 7 2 ' into the program storage. Register 1 
in the LSB contains the address of the failing instruction in 
the case of a program check. 

The following example shows a specification check which 
occurred at location X * 5 3 C ' . 
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MULTIPLE TERMINAL MANAGER SYSTEM FAILURE > $A 

PROGRAMS AT 00:06:24 IN PARTITION #2 $MTM 0000 * 
CDMSVR33 6C00 > $D 172 30 X 0172: 8002 28E6 0110 10D0 
ODDC 053C ODAC 7361 

0182: 0540 815C 00B8 ODDA 0000 OOFA 0004 0028 

0192: 0052 007C 00A6 0017 0E72 A0A2 0E72 FFFF 

01A2: 0102 8026 1616 40C9 D5C9 E3C9 

ANOTHER DISPLAY? 



The PSW is 8002 at 0172 and Rl is 053C on same line. 

System Act i on : The Multiple Terminal Manager program remains 
active waiting for an event which will not be posted. 

Response : Use Event Driven Executive operator facilities to 
d i sp lay storage . 



MULTIPLE TERMINAL MANAGER TERMINAL FILE RECORDS 

Issued By: Multiple Terminal Manager 

Explanat i on : The TERMINAL file records processed by the Mul- 
tiple Terminal Manager are listed after this message. Any 
messages pertaining to a specific TERMINAL file record will 
be displayed immediately after the f \ I e record. 

System Act i on : TERMINAL file records processed are listed. 

Response : Review the listing and take action as needed. 
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MTMSTORE DATA SET LIMITS EXCEEDED 

Issued By : Multiple Terminal Manager 

Exp 1 anat i on : The specified MTMSTORE file is too small. This 
can occur after adding a new program with a storage require- 
ment greater than any previous program's requirement or 
after adding a new terminal or screen. 

System Act i on ' The manager terminates. 

Response : Delete the MTMSTORE file and recreate it with more 
space . 



NO BUFFER SUPPLIED. $IAMUT1 TERMINATING 

Issued By: $IAMUT1 

Exp 1 anat i on : The $STORAGE field in program header was set to 
and no buffer exists for $IAMUT1. 

System Act i on ♦ The program terminates. 

Response : Use the SS command of $DISKUT2 to set the $ST0RAGE 
field to the desired buffer size (must be > 0). For L > U N , a n d 
RO commands* this buffer must be large enough to contain the 
entire input and /or output record (whichever is larger). 



NO PROGRAM LOAD FACILITY 

Issued Bv ' Load Utility Program 

Explanat i on : The load utility program ( $ L A D E R ) cannot be 
found on the IPL volume. 

System Action: The Load utility is terminated. 

Response: If $L0ADER is not on the IPL volume, you must copy 
$L0ADER from XS-3001 to the IPL volume and restart the Load 
utility. 
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NO TERMINALS ARE AVAILABLE 

Issued Bv : Multiple Terminal Manager 

Explanation: No valid terminal specification records were 
found in the TERMINAL file* or, no terminal servers can be 
loaded, or, all terminals are busy. Other messages generated 
indicate the problem area. 

System Act i on : The manager terminates. 

Response: Determine the cause of the problem and take correc- 
tive action. 



\mi*y 



NO TRAP CONDITIONS SPECIFIED. 
$TRAP TERMINATED 

Issued By: $TRAP Utility 

Explanation? No trap conditions were specified. Some are 
requ i red . 

System Act i on : The STRAP utility is terminated. 

Response : Specify the necessary trap conditions and restart 
the STRAP uti li ty . 



NULL INVALID FOR PARAMETER 

Issued By: SIAMUT1 

Explanation: An attempt was made to specify a null response 
(&) to a parameter on which this is invalid. 

System Act i on : Reprompts for parameter. 

Response : Enter the proper response to the parameter prompt. 
See determining data set size and format section in the 
$ I A M U T 1 chapter of the utilities manual for a description of 
each parameter. A null response is only valid for RSUBCK, 
RSUIX, FPOOL AND DELTHR parms. 
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OPEN FOR LOAD RETURN CODE = xxx. RETRY ?: 

Issued By: $IAMUT1 

Explanation: $ I A M U T 1 attempted to open the specified IAM 
file in LOAD mode and a bad return code was received from the 
IAM request . 

System Act i on : If retry = Y, reprompts for DSNAME> VOLUME and 
retries the IAM open request. If retry = N, command termi- 
nates . 

Response : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 



OPEN FOR PROCESS RETURN CODE = xxx. RETRY?: 

Issued By: SIAMUT1 

Exp lanat i on : SIAMUT1 attempted to open the specified IAM 
file in process mode and a bad return code was received from 
the IAM request. 

System Action: If retry = Y, reprompts for DSNAME* VOLUME and 
retries the IAM open request. If retry = N> the command ter- 
minates. 

Response : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 



PARTITION NUMBER IS INVALID 

Issued By: $DUMP Utility 

Explanation: An invalid partition number was entered during 
a partial storage dump. 

System Action: The $DUMP utility is terminated. 

Response : Enter a valid partition number and restart the 
$DUMP uti lity. 



\. 
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PRIMARY MENU mmmmmmmm FAILED FOR TERMINAL tttttttt 

Issued By: Multiple Terminal Manager 

Explanation: A SETPAN function failed for the terminal 
tttttttt using the primary menu mmmmmmmm. 

System Act i on : The primary menu is not displayed. 

Response : Ensure that a valid menu name is specified in the 
TERMINAL file for the specified terminal. 



y 



PROGRAM AREA TOO SMALL TO HOLD PGM pppppppp 

Issued By: Multiple Terminal Manager 

Explanation: The manager's program area is too small to hold 
the named program. 

System Action: The program is not used. 

Response : increase the program area size by reallocating 
CDMDUMMY or split the program into smaller link-edited pro- 
grams . 



PROGRAM CAPACITY EXCEEDED 

Explanation: 

The amount of working storage allocated to $VERIFY is insuf- 
ficient to process the indexed data set specified. 

System Act i on : 

$VERIFY terminates. 

Response : 

Increase the amount of working storage available to SVERIFY. 
Refer to Modifying Working Storage Requirements for a 
description of how to calculate the amount of working storage 
required and how to modify the amount supplied. 
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PROGRAM FILE LARGER THAN PROGRAM MANAGER BUFFER 

Issued Byi Multiple Terminal Manager 

Exp lanat i on : The program table built during initialization 
exceeds the size of the buffer used by the program manager. 

System Action* Multiple Terminal Manager terminates. 

Response : Increase the program manager buffer size in module 
CDMCOMMN. 



PROGRAM LOAD ERROR 

Issued By : Multiple Terminal Manager 

Explanation: An Event Driven Executive LOAD error occurred 
for the requested program. 

System Ac t i on s The program is not loaded. 

Response : Determine the cause of the problem. Rebuild the 
program if the problem persists. 



PROGRAM xxPiOO.00.00, LP=zzzz 

Issued By> Program Load 

Exp lanat i on : Any program invoked using $L (Load a Program) 
results in this message being displayed, indicating that the 
program you requested has been loaded. Here, xxP indicates 
that the program is xx pages long (256 bytes equals one 
page). 00.00.00 is the time in hours, minutes and seconds. 
LP=xxxx indicates that the load point of the program is at 
location X'zzzz'. If the timer support is not included in 
the supervisor, the time is not printed. 

System Act i on ' None. 

Response : None . 
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READ INPUT DATASET RETURN CODE = xxx. RECORD NUMBER = xxxxxx 

Issued By: $IAMUT1 

Explanation; An attempt to read the indexed input data set 
failed for a sequential data set. 

System Action? Command terminates. 

Response : LO command - check the READ/WRITE return codes to 
find the cause of the problem and take the appropriate 
action. UN, RO commands -check the Indexed Access Method 
return codes find the cause of the problem and take the 
appropriate action. 



c 



RECONNECT SYNTAX INVALID 

Issued By: Multiple Terminal Manager 

Exp 1 anat i on : The correct syntax was not used on the RECONNECT 
operator command. 

System Act i on : The command is ignored. 

Response : Retry the RECONNECT command with correct syntax. 

RECONNECT TERMINAL DEFINITION ERROR 

Issued By : Multiple Terminal Manager 

Explanation: The RECONNECT operator interface facility has 
encountered a failure while attempting to reconnect a termi- 
nal to the Multiple Terminal Manager. Since initialization 
would have already performed all functions necessary to 
include the terminal in the terminal table, the TERMINAL 
file, SCRNS volume or source table in RECONNEC has probably 
been altered since the Multiple Terminal Manager was 
started . 

System Act i on : Terminal is not connected. 

Response : Determine the cause of the error (check TERMINAL 
file for correct data). 
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SCREEN TABLE LARGER THAN INPUT BUFFER 

Issued By : Multiple Terminal Manager 

Explanation? The screen table built during initialization 
exceeds the Input Buffer size. 

System Ac t i on ' Initialization is aborted. 

Response : Increase the Input Buffer size in module CDMCOMMN. 



SENSOR I/O DEVICE AT ADDRESS xxxx IS OFFLINE 
BSCA NOT THE DEVICE AT ADDR: zzzz 

Issued By ? Sensor I/O Status Check 

Explanation: The system checks the status of any defined sen- 
sor I/O or Binary Synchronous Communications Adapter devices 
and prints appropriate status messages. 

System Ac t i on ? None. 

Response ? None. 



SET DATE AND TIME USING COMMAND $T 

Issued By: System 

Exp lanat i on : If timer support was included during system 
generation, the system prints a message indicating that the 
date and time can be optionally entered (or reset) using the 
$ T supervisor utility. 

System Action? None. 

Response t None. 



s x 



V 



435.11 SC34-0313 



Page of SC34-03 13-2 

As updated February 13, 1981 

By TNL SN34-0684 



Messages 



SIGNON PROGRAM NOT AVAILABLE FOR TERMINAL tttttttt 

Issued By : Multiple Terminal Manager 

Explanation? The specified terminal is required to sign on 
and off but no program named SIGNON was found in the PRGRMS 
vol ume . 

System Action: The terminal is not signed on. 

Response : Place a program named SIGNON in the PRGRMS file or 
designate that no signon is needed for the specified 
terminal. Reconnect terminal. 






TAPE xxxx IS NOT A TAPE * * * 
TAPE XXXX MARKED UNUSABLE 

Issued By : Tape Initialization 

Exp lanat i on : If an address is incorrectly defined (for exam- 
ple, the device is not a tape)? if the tape drive is not 
turned on, or if the tape drive has a hardware failure, mes- 
sages describing the problem are issued. 

System Action: The initialization is terminated. 

Response : Correct the problem and restart the 
initiali zation. 



TAPE xxxx OFFLINE FOR BLP yyyy BPI 

Issued By : Tape Initialization 

Explanat i on : If the address (yyyy) is valid and the tape is 
not mounted this message is printed. 

System Action: The initialization is terminated. 

Response : Mount the tape and restart the initialization. 
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TAPE xxxx TAPE01 ONLINE FOR BLP yyyy BPI 

Issued By : Tape Initialization 

Explanat i on : If the address (yyyy) is valid and the tape is 
mounted this message is printed. 

System Action? None . 

Response : None. 



TERMINAL tttttttt BUSY 

Issued By: Multiple Terminal Manager 

Exp lanat i on : Terminal tttttttt specified in the TERMINAL 
file is connected to another program. 

System Action: The terminal is not used. 

Response : Try to RECONNECT at a later time. 



X,.; 



TERMINAL tttttttt NOT DEFINED IN EVENT DRIVEN EXECUTIVE SYSTEM 

Issued By : Multiple Terminal Manager 

Explanation: The specified terminal was not included in the 
definition of terminals when the Event Driven Executive sys- 
tem was generated. 

System Act i on : The terminal is not connected. 

Response : Include a terminal definition for the specified 
terminal when the Event Driven Executive system is 
generated . 



vy 
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TERMINAL tttttttt RECONNECTED 

Issued By ' Multiple Terminal Manager 

Explanation: The named terminal has been reconnected to the 
Multiple Terminal Manager. 

System Action: The terminal is reconnected to the Multiple 
Terminal Manager. 

Response : Use the terminal as needed. 



•% 



TERMINAL NAME INVALID 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The terminal name specified for the TERMINAL 
file record listed immediately before this message is inval- 
id. 

System Act i on : The terminal is not connected. 

Response : Correct the TERMINAL record. Stop and restart the 
manager . 



TERMINAL TABLE OR STORAGE SIZE EXCEEDED 

Issued By : Multiple Terminal Manager 

Exnlanat i on : While building the terminal table and loading 
servers, the storage size or the the maximum number of termi- 
nals (10) allowed has been exceeded. The work space* defined 
in CDMINIT, is defined to allow a maximum of 50 terminals. 

System Act i on t The extra terminals are not connected. 

Response : Increase the terminal table size by changing mod- 
ule CDMCOMMN. If there is not enough room, make the parti- 
tion larger, decrease the number of terminals, or make 
CDMDUMMY smaller. 



Chapter 6. Messages and Codes 435.14 



Page of SC34-03 13-2 

As updated February 13, 1981 

By TNL SN34-0684 



Messages 



V.,/"' 



VALUE OUT OF RANGE 

Issued By: $IAMUT1 

Exp 1 anat i on : An invalid value was entered for the parameter 
prompt . 

System Act i on ' Reprompt for parameter. 

Response ' Enter the proper response to the parameter prompt. 
See Determining Data Set Size and Format section under 
$ I A M U T 1 chapter of Utilities manual for a description of each 
parameter . 



VERIFICATION COMPLETE, ERROR(S) ENCOUNTERED 

Explanation: 

$VERIFY has completed normally. 

System Action? 

SVERIFY terminates. 

Response : 

Examine any reports printed as needed. 
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WRITE OUTPUT DATASET RETURN CODE = xxx. RECORD NUMBER = 
xxxxxx. 

Issued By: $IAMUT1 

Explanation: An attempt to write to a sequential (output) 
data set failed. 

System Action? Command terminates. 

* 

Response : LO, RO commands - Check the Indexed Access Method 
return code to find the cause of the problem and take the 
appropriate action (N0TE1). UN command - Check the 
READ/WRITE return code to find the cause of the problem and 
take the appropriate action (N0TE2). 

NOTE 1 : It may be necessary to redefine data set ( S E > D F ) and 
retry LO command. 

N0TE2 : It may be necessary to reallocate the data set and 
retry the UN command. 



xxxxxxxx DISCONNECT 

Issued By? Multiple Terminal Manager 

Exp lanat i on : Terminal xxxxxxxx has been issued a successful 
DISCONNECT command. 

System Action; The terminal is disconnected. 

Response : Reconnect terminal as needed. 

xxxxxxxx PROGRAM TYPE INVALID 

Issued By: Multiple Terminal Manager 

Explanat i on : Program xxxxxxxx in the PRGRMS volume is not a 
program type data set. 

System Act i on : The program named is not used. 

Response : Specify program type members only for use as pro- 
grams . 
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xxxxxxxx SCREEN SIZE TOO LARGE 

Issued By? Multiple Terminal Manager 

Explanation* Screen xxxxxxxx in the SCRNS volume will not fit 
in the screen manager buffer. 

System Act i on : The screen is not available during this Multi- 
ple Terminal Manager session. 

Response t Increase the screen manager buffer size in 
CDMCOMMN. 



xxxxxxxx SETPAN FAILED* RC=xxx 

Issued By * Multiple Terminal Manager 

Explanation? A SETPAN failed for the screen named xxxxxxxx. 

System Action: Processing continues. 

Response '. Check the Multiple Terminal Manager return code to 
find the cause of the problem and take the appropriate 
action. 
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Program Check Error Message 

If a program check occurs during execution of a program, a mes- 
sage with the following format is printed on the loading 
terminal: 




^kn^y' 



where : 

PLP The program load point of the failing program. 

TCB The location of the task control block for the failing 
program (the address appearing on the assembly listing). 

PSW The processor status word when the check occurred (de- 
scribed under Processor Status Word) 

LSB Level status block, consisting of the following: 



WORD 1 
WORD 2 
WORD 3 
WORD 4 



- 11 - 



- instruction address register (IAR) 

- address key register (AKR) 

- level status register (LSR) 
general registers (R0-R7) 



If the program is written in assembler language, COBOL, 
FORTRAN, or PL/I, the contents of the registers depend upon the 
conventions unique to that language. If the program is written 
in Event Driven Language, registers through 7 (words 4-11) 
contain: 
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WORD 


4 - 


(R0) 


WORD 


5 - 


(Rl) 


WORD 


6 - 


(R2) 


WORD 


7 - 


(R3) 


WORD 


8 - 


(R4) 


WORD 


9 - 


(R5) 


WORD 


10 - 


CR6) 


WORD 


11 - 


(R7) 



work register 

address of Event Driven Executive 

instruction 

address of EDL TCB 

address of EDL operand 1 

address of EDL operand 2 

EDL command 

work reg i ster 

work reg i ster 



The program in which the error occurred is either aborted or, 
if it has a task error exit, the exit is entered. In either 
case, normal system execution is resumed after the program 
check message has been printed. 



System Program Check Error Message 



If a program check occurs in the supervisor, the following mes- 
sage prints on the SSYSLOG terminal: 



\^ / 



SYSTEM PGM CHK: PSW AND LSB 
8000 0000 1014 80DP 6F00 6F22 



1015 54F5 6F26 805C 



where 



WORD 


1 


WORD 


2 


WORD 


3 


WORD 


4 



- 11 



- processor status word (PSW) 

- instruction address register (IAR) 

- address key register (AKR) 

- level status register (LSR) 



Processor Status Word (PSW) 



The processor status word (PSW) is used to record error or 
exception conditions in the system that may prevent further 
processing. It also contains certain status flags related to 
error recovery. Error or exception conditions recorded in the 
PSW cause four of the possible seven class interrupts to occur. 
These sre machine check, program check, soft exception trap, 
and power/thermal warning. 
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The Copy Processor Status and Reset (CPPSR) instruction can be 
used to examine the PSW. This instruction stores the contents 
of the PSW into a specified location in main storage. 



The PSW is contained 
bit representation: 



in a 16-bit register with the following 






Processor 

Type 495x 

Bit 2 3 5 



Condi ti on 



Class 
Interrupt 



Note 



00 X X X Specification Check 

01 X X X Invalid Storage Addr 

02 X X X Pri vi lege Violate 

03 X X Protect Check 

X Not Used 

04 X X X Invalid Function 



05 X Floating Point 

Exception 

X X Not Used 

06 X X X Stack Exception 

07 - Not Used 

08 X X X Storage Parity Check 

09 - Not Used 

10 X X X CPU Control Check 

11 X X X I/O Check 

12 X X X Sequence Indicator 

13 X X X Auto IPL 

14 X X Translator Enabled 

X Not Used 

15 X X X Power/Thermal Warning 



Program Check 
Program Check 
Program Check 
Program Check 



Soft Exception 

Trap 

Soft Except i on 

Trap 

Soft Except i on 
Trap 

Mach i ne Check 

Mach i ne Check 

Machine Check 

None 

None 

None 

Power/Ther ma 1 



Notes: 

1 . Always Zero 

2 . Status Flag 

3. Controlled by summary mask 
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Following is an explanation of the bit representations* 

Bit 00 Specification Check : Set to one if (1) the storage 
address violates the boundary requirements of the specified 
data type, or ( 2 ) the effective address is odd when attempting 
to execute a floating-point instruction and the floating-point 
feature is not installed. 

Bit 01 Invalid Storage Address : Set to one when an attempt is 
made to access a storage address outside the storage size of 
the system. This can occur on an instruction fetch, an operand 
fetch, or an operand store. 



Bit 02 P r i v i 1 e a e 



Violate *■ Set to one when a privileged 
in the problem state (supervisor 



instruction is attempted 

state bit in the level status register is not on). 



Bit 03 Protect Check : In the problem state, this bit is set to 
one when (1) an instruction is fetched from a storage area not 
assigned to the current operation, (2) the instruction 
attempts to access a main storage operand in a storage area not 
assigned to the current operation, or (3) the instruction 
attempts to change a main storage operand in violation of the 
read-only control. 

Bit 4 Invalid Function : Set to one by the following 
conditions*. 

1. Attempted execution of an illegal operation code or func- 
tion combination. These are: 



Op code 


Funct 


00101 


All ( 




Rl or 


00111 


All 


01000 


0001 , 


01011 


0001 , 




the r 




i nsta 


01011 


0101 , 


01100 


111 


OHIO 


11000 


11011 


All 


10110 


All 


11101 


1100, 



i on 

when register 7 is specified in the 
R2 field of the instruction) 

0010, 0011, 0101, 0110, 0111 

1001 (when in supervisor state and 

elocation translator feature is not 

lied) 
0111 

, 11010, 11011, 11100, 11110, 11111 



1101, 1110, 1111 



Note: The preceding illegal conditions cause a program 
check class interrupt to occur. 
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2 . The processor attempts to execute an instruction associ 
ated with a feature that is not installed. These are: 






Op code Function 

00100 All (floating-point feature not installed) 
01011 0011, 1011 (if the floating-point feature 

is not installed and the processor is in 

supervisor state) 

Note: The preceding condition causes a 
soft-exception-trap class interrupt to occur. 

Bit 05 Floating-Point Exception : Set to one when an exception 
condition is detected by the option floating-point processor. 
The arithmetic indicators (carry, even, and overflow) define 
the specific condition. 

Bit 06 Stack Exception : Set to one when an attempt has been 



made to pop an operand from an empty main storage stack or push 
an operand into a full main storage stack. A stack exception 
also occurs when the stack cannot contain the number of words 
to be stored by a Store Multiple (STM) instruction. 

Bit 08 Storage Parity : Set to one when a parity error has been 
detected on data being read out of storage by the processor. 
This error may occur when accessing a storage location that has 
not been validated since power on. 



Bit 10 CPU Control Check: 



els are active but 

machine-wide error. (See I/O check note.) 



A control check will occur if no lev- 
execution is continuing. This is a 



Bit 11 I/O Check : Set to one when a hardware error has occurred 
on the I/O interface that may prevent further communication 
with any I/O device. PSW bit 12 (sequence indicator) is a zero 
if the error occurred during an Operate I/O instruction and is 
set to one if the error occurred during a non-DPC transfer. The 
sequence indicator bit is not an error in itself but reflects 
the last interface sequence at any time. An I/O check cannot be 
caused by a software error. (See note.) 

Note? The machine check class interrupt initiated by a CPU 
control check or I/O check causes a reset. The I/O channel 
and all devices in the system are reset as if a Halt I/O 
(channel directed command) had been executed. The process- 
or, sensor-based output points, and timer values are not 
reset . 



Bit 12 Sequence Indicator : 
interface sequence to occur. 



This bit reflects the last I/O 
See I/O check described above. 
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Bit 13 Auto IPL : Set to one by hardware when an automatic IPL 
occurs . 

Set to zero by : 

• A power on reset when Auto IPL mode is not selected 

• Pressing the Load key 

• An IPL initiated by a host system 

Refer to the appropriate hardware manual for a description of 
initial program load. 

Bit 14 Translator Enabled : When the Storage Address Relocation 
Translator Feature is installed, this bit is set to one or zero 
as foil ows : 

1. Set to one (enabled) 

• An Enable (EN) instruction is executed with bit 12 of 
the instruction word set to zero and bit 14 set to one 

2. Set to zero (disabled) 

• A Disable (DS) instruction is executed with bit 14 of 
the instruction word set to one 

• An Enable (EN) instruction is executed with bit 12 of 
the instruction word set to one 

• A processor reset (power-on reset, check restart, IPL, 
or system reset key) 

Bit 15 Power Warning and Thermal Warning : Set to one when these 
condition occur (refer to the appropriate hardware manual for a 
description of a Power/Thermal Warning class interrupt). The 
power/thermal class interrupt is controlled by the summary 
mask . 

For a description of class interrupts, I/O interrupts and the 
basic instruction set (including indicator settings and possi- 
ble exceptions conditions) for your specific processor, refer 
to the appropriate hardware manual. 



\^_? / 
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CODES 

This section presents three types of codes issued by the Event 
Driven Executive: 

Completion Issued by utility programs upon completion to 
indicate if execution was successful or not 



Return 



Issued as the result of executing an Event Driven 
language instruction or subroutine to indicate 
success or failure of the operation 



Post 



Issued by the system to signal the occurrence of an 
event 



The codes and their meanings are presented by type and alpha- 
betically by functional grouping. 



Utility Completion Codes 



The completion codes and their meanings are presented in alpha- 
betic order according to function as follows: 

$EDXASM 

SIAMUTl 

SJOBUTIL 



$LINK 
$UPDATE 



x„V 



The utility completion codes are printed on the specified list 
device by the utility programs upon their completion unless 
otherwise noted. 



o 
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$EDXASM Completion Codes 

$EDXASM completion codes are accompanied by an appropriate 
error message and appear at the end of the $ E D X A S M listing. The 
completion codes can be tested by the job stream processor, 
allowing steps subsequent to the assembly to be skipped, if 
appropriate. The completion codes are: 



Comp let i on 
Code 



-1 

8 

12 

12 

12 
12 

100 



Cond i t i on 



Successful completion - no errors 

in assembly 

Successful completion - one or more 

statements had assembly errors 

Out of space in work or object 

data set 

I/O error in source, work, or 

object data set 

Over lay- i nstr uct i on table full 

Unable to locate overlay program 

or copy code module 

Operator cancelled assembly with 

ATTN CA command 
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SIA^UTl Completion Codes (Part 1 of 2) 



Complet i on 
Code 



Cond i t i on 



-1 
01 
02 
03 
04 
05 
06 
07 
08 
12 
13 
23 
31 
32 
34 
36 

37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 

54 
55 



Successful completion 

Data set not found (OPEN failed) 

Invalid IODA exit (OPEN failed) 

Volume not mounted (OPEN failed) 

Library not found (OPEN failed) 

Disk I/O error (OPEN failed) 

No VTOC exit address (OPEN failed) 

L i nk modu le in use 

Load error for $IAM 

Data set shut down 

Module not included in load module 

Get storage error - IACB 

FCB WRITE error during IDEF processing 

Blocksize not multiple of 256 

Data set is too small 

Invalid block size during file definition 

process i ng 

Invalid record size 

Invalid index size 

Record size greater than block size 

Invalid number of free records 

Invalid number of clusters 

Invalid key size 

Invalid reserve index value 

Invalid reserve block value 

Invalid free pool value 

Invalid delete threshold value 

Invalid free block value 

Invalid number of base records 

Invalid key position 

Data set is opened for exclusive use 

Data set opened in load mode 

Data set is opened, cannot be 

opened exclusively 

Invalid block size during PROCESS or LOAD 

Get storage for FCB error 
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$IAMUT1 Completion Codes (Part 2 of 2) 



Comp let i on 
Code 



Cond i t i on 



56 
60 

61 

62 

100 

101 

110 



FCB READ error 

LOAD mode key is equal to or less than 

previous high key in data set 

End of file 

Duplicate key found 

READ error 

NR ITE error 

WRITE error - data set closed 
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SJOBUTIL Completion Codes 

The $JOBUTIL completion codes are displayed on the terminal 
used to access SJOBUTIL. The codes are as follows. 



Complet i on 
Code 



-1 
61 

64 

67 

70 

71 

72 

73 

74 
75 
76 
77 
78 

79 

80 



Cond ition 



Successful completion 

The transient loader (SLOADER) is not 

included in the system 

No space available for the transient 

loader 

A disk or diskette I/O error occurred 

during the load process 

Not enough main storage available for 

the program 

Program not found on the specified 

vo 1 ume 

Disk or diskette I/O error while 

reading directory 

Disk or diskette I/O error while reading 

program header 

Referenced module is not a program 

Referenced module is not a data set 

Data set not found on referenced volume 

Invalid data set name 

LOAD instruction did not specify 

required data set(s) 

LOAD instruction did not specify 

required parameter(s) 

Invalid volume label specified; for 

example* greater than eight characters 



v_v 
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$LINK Completion Codes (Part 1 of 3) 






Cotnp . 




Cause 


Action 


Ret ur 


Code 


Condition 


code 


code 


code 


- 


Successful completion 


- 


- 


-1 


01 


DS2 less than 265 records 


1 


2 


12 


02 


Disk error reading DS1 


2 


2 


12 


03 


End of file reached on DS1 


1 


3 


4 


04 


Disk error reading object 










modu le 


2 


1 


8 


05 


Invalid 'OUTPUT' record 


1 


2 


12 


06 


Invalid 'INCLUDE' record 


1 


6 


8 


07 


Error opening object output 










modu le : 


1 


5 


12 




- misspelled name or 










volume 










- data set not allocated 








08 


Error opening input object 










module (see Error 07) 


1 


6 


8 


09 


Error opening output module 
( hardware error) 


2 


5 


12 


10 


Error opening an input 
module (hardware error) 


2 


6 


8 


11 


Error opening autocall list 
(DS9). See Error 07 for 










causes 


1 


5 


12 


12 


Error opening autocall list 










(DS9) (hardware error) 


2 


5 


12 


13 


Invalid input object module 










record type 


4 


4 


8 


14 


Entry point label not found 


1 


3 


4 


15 


No valid ESDID for TXT or 










RLD 


4 


4 


8 


16 


Invalid ESD item type 


4 


4 


8 


17 


Duplicate ESDID number 


4 


4 


8 


18 


Invalid Symbol 


4 


4 


8 


19 


Duplicate Entry point 










symbol 


3 


4 


8 


20 


Invalid ESDID number 


4 


4 


8 


22 


Invalid ESD symbol 


4 


1 


8 
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Completion Codes 



\ J 



$LINK Completion Codes (Part 2 of 3) 



Comp . 




Cause 


Act i on 


Return 


Code 


Condition 


code 


code 


code 


23 


End of file reached on DS9 


1 


2 


12 


24 


Disk error reading DS9 


2 


2 


12 


25 


Disk error reading DS4 


2 


2 


12 


26 


End of File reached on DS3 


6 


2 


12 


27 


Disk error Read/Write 










on DS8 


2 


2 


12 


28 


End of file reached on D58 


5 


2 


12 


29 


End of file reached on DS7 


6 


2 


12 


30 


End of file reached on DS4 


6 


2 


12 


31 


Disk error writing on DS5 


2 


2 


12 


32 


End of file reached on DS5 


5 


2 


12 


33 


End of file reached on DS2 


6 


2 


12 


34 


Duplicate section definition 










(CSECT) 


3 


1 


4 


36 


End of file reached on DS6 


4 


1 


8 


37 


Disk error, read/write on 










DS7 


2 


2 


12 


38 


Disk error, read/write on 










DS3 


2 


2 


12 


39 


Invalid RLD record data 










length 


4 


4 


8 


40 


Disk error, read/write on 










DS2 


2 


2 


12 


42 


DS2 not large enough 










(program size over 64K) 


5 


2 


12 


45 


No 'INCLUDE* records 


1 


2 


12 


46 


No CSECT length field 


4 


3 


4 


None 


Unresolved EXTRN 






4 



o 



436.6 SC34-0313 



Page of SC34-03 13-2 

As updated February 13, 1981 

By TNL SN34-0684 



Completion Codes 



$LINK Completion Codes (Part 3 of 3) 






Caus e Codes 



1 - 

2 - 

3 - 

4 - 

5 - 

6 - 



Your error 

System error 

Possible duplicate 'name, volume' or duplicate CSECT 

or ENTRY names 

Input object record(s) in error. Probable cause is 

that 'name, volume' is not a valid object module 

Data set is of insufficient size 

Probable $ L I N K error, this condition should not 

occur 



Action Codes 



1 - 

2 - 

3 - 

4 - 

5 - 

6 - 



Log warning message and continue at next 'INCLUDE' 

Terminate $LINK with error message 

Continue as if expected occurance had happened 

Log error message plus invalid object module 

record and continue at next 'INCLUDE' 

Log error message plus OUTPUT record and 

terminate $LINK 

Log error message plus INCLUDE record, continue 

at next 'INCLUDE' 



Return Code Definitions 

-1 Successful completion 
4 Warning? A module has been written 

execution will probably work 
8 Warning: A module has been written 
execution will probably fail 
12 Severe error: Module is not written 
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Completion Codes 






$UPDATE Completion Codes 

The SUPDATE completion codes are displayed on the terminal used 
to access SUPDATE. The codes are as follows: 



Complet i on 




Code 


Cond i 


-1 


Succe 


8 


No su 


8 


Outpu 


8 


Disk 


8 


No sp 


8 


No sp 


8 


In val 


8 


In val 


8 


Disk 


8 


Di sk 


8 


Libra 


8 


Input 


8 


No pa 


8 


No da 


8 


Rep la 


12 


Any d 



ssful completion 

pervisor space in this library 

t name specified is not a program 

volume already in use by another program 

ace in directory 

ace in data set (output library) 

id header format 

id program name 

volume not mounted 

vol ume off line 

ry not found 

data set not found 
rameter supplied via SJOBUTIL 
ta set names provided via SJOBUTIL 
cement of output data set not allowed 
isk or diskette I/O errors 



x_y 
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4*\ 



EVENT DRIVEN LANGUAGE AND FUNCTION RETURN CODES 

The return codes and their meanings are presented in alphabetic 
order according to function as follows: 

$DISKUT3 

$PD5 

BSC 

Data Formatt i ng 

Disk and Tape (READ/WRITE) 

EXIO 

F loat i ng-po i nt 

Formatted Screen Image as follows: 
SIMDATA subroutine 
$1 MO PEN subroutine 
$IMPROT subroutine 

Indexed Access Method 

Multiple Terminal Manager 

SBIO (Sensor Based I/O) 

Terminal I/O as follows: 
Genera 1 
ACCA 

Interprocessor Communications 
V i rt ua 1 Term i na 1 

TP (Host Communication Facility) 



The return codes are issued by EDL instructions and 
EDL-invokable functions. They are returned in the first word 
of the task control block of the calling program unless other- 
wi se noted . 



^Ly|||F 
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$DISKUT3 Return Codes 

The SDISKUT3 utility places a return code in the first word of 
the DSCB specified. The return codes for $DISKUT3 are listed 
below. 



Return 
Code 



Cond i t i on 



10 
11 

12 

13 
14 
15 
16 
17 

18 

19 
20 
21 



Invalid 
Volume d 
Insuf f i c 
I n s u f f i c 
Data set 
requeste 
Insuf f i c 
Disallow 
$EDXLIB 
Data set 
(OPEN, R 
New name 
Disk is 
(ALLOCAT 
I/O erro 
(ALLOCAT 
I/O erro 
Data set 
Invalid 
Invalid 
M i smatch 
(DELETE, 
Data set 
requeste 
SETEOD o 
Load of 
Tape dat 



reques 
oes no 
i ent s 
i e n t s 

al rea 
d alio 
i ent c 
ed dat 
(All f 

not f 
ELEASE 

point 
busy 
E, DEL 
r writ 
E, DEL 
r read 

name 
size s 
size s 
ed dat 

OPEN, 

al rea 
d alio 
n ly va 
SDISKU 
a sets 



t CO 

t ex 
pace 
pace 
dy e 
cat i 
ont i 
a se 
unct 
ound 
, RE 
er i 

ETE, 
i ng 
ETE, 
i ng 
i s a 
pec i 
pec i 
a se 

REL 
dy e 
cat i 
lid 
T3 f 

are 



de parameter (not 1-6) 

i st (All f unct i ons ) 
in library (ALLOCATE) 
in directory (ALLOCATE) 

xists - smaller than the 

on 

guous space (ALLOCATE) 

t name, eg. $EDXV0L or 

ions) 

NAME) 

s zero (RENAME) 



RELEASE, 
to disk 

RELEASE, 
from disk 
1 1 blanks 
f i cat i on 



RENAME) 

RENAME) 

(All f unct i ons ) 

(ALLOCATE, RENAME) 

(ALLOCATE) 

(RELEASE) 



f i cat i on 
t type 

EASE, RENAME) 
x i sts - larger 
on 

for data set of type 
ai led ($RMU only) 
not supported 



than the 

' data ' 



o 
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Return Codes 



$PDS Return Codes 

The $PDS utility returns the status of an event in the event 
control block (ECB) specified by the EVENT= parameter on the 
LOAD instruction. The return codes for $PDS are listed below. 



Return 
Code 



-1 
1 
2 
3 

5 
7 
8 
9 
10 



Condition 



Successful operation 

Member not found 

Member already allocated 

No space 

D i rectory is full 

Member was not used 

Record not in member 

Member control block invalid 

Space not released 

Not a data member 
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Return Codes 






BSC Return Codes 



Return 
Code 



END; 

1 
2 
3 
4 
5 
6 



ERROR 

10 
11 
12 
13 
14 
15 
20 
21 
22 
23 
24 
25 
30 
31 
32 
33 
34 

35 
99 



Condition 



Notes 



Text received in conversational mode 
Successful completion 



EOT rece i ved 

DLE EOT rece i ved 

Reverse interrupt received 

Forward abort received 

Remote station not ready (NAK received) 

Remote station busy (WACK received) 



Time-out occurred 1 
Unrecovered transmission error (BCC error) 1 

Invalid sequence received 3 
Invalid multi-point tributary write attempt 2 

Disregard this block sequence received 1 

Remote station busy (WACK received) 1 

Wrong length record - long (No COD) 6 

Wrong length record - short (write only) 2 

Invalid buffer address 2 

Buffer length zero 2 

Undefined line address 2 

Line not opened by calling task 2 

Modem interface error 2 

Hardware overrun 2 

Hardware error 5 

Unexpected rit^g interrupt 2 
Invalid interrupt during auto-answer 

attempt 2 

Enable or disable DTR error 2 

Access method error 2 



Vj* ; 



Notes: 

1. Retried up to the limit specified in the RETRIES= operand 
of the BSCLINE definition. 

2 . Not retr i ed . 
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Return Codes 






3. Retried during write operation only when a wrong ACK is 
received following an ENQ request after timeout (indicat- 
ing that no text had been received at the remote station). 

4. Returned only during an initial sequence with no retry 
attempted . 

5. Retried only after an unsuccessful start I/O attempt. 

6. Retried only during read operations. 
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Return Codes 



4 \^ 



Data Formatting Return Codes 



Return 
Code 



Description 



-1 
1 
2 
3 



Successful completion 
No data in field 
Field om i tted 
Convers i on error 



These return codes are issued by the CONVTB, CONVTD, GETEDIT, 
and PUTEDIT instructions. 
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Disk and Tape (READ/WRITE) Return Codes 

Disk and tape return codes resulting from READ/WRITE 
instructions are returned in two places: 

1. the Event Control Block (ECB) named DSn t where n is the 
number of the data set being referenced. 

2. the task code word referred to by taskname. 

The disk and tape return codes and their meanings are shown 
below . 






If further information concerning an error is required* it may 
be obtained by printing all or part of the contents of the Disk 
Data Blocks (DDBs) located in the Supervisor. The starting 
address of the DDBs can be obtained from the linkage editor map 
of the supervisor. The contents of the DDBs are described in 
the Interna 1 Design . Of particular value are the Cycle Steal 
Status Words and the Interrupt Status Word save areas, along 
with the contents of the word that contains the address of the 
next DDB in storage. 
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Disk Return Codes 



Return 
Code 



-1 
1 



9 
10 

11 

12 



Cond i t i on 



Successful completion 

I/O error and no device status present 

(this code may be caused by the I/O area 

starting at an odd byte address) 

I/O error trying to read device status 

I/O error retry count exhausted 

Read device status I/O instruction error 

Unrecoverable I/O error 

Error on issuing I/O instruction for 

normal I/O 

A 'no record found 1 condition occurred* 

a seek for an alternate sector was performed* 

and another 'no record found' occurred* 

for example* no alternate is assigned 

Device was 'offline' when I/O was requested 

Record number out of range of data set— may 

be an end-of-file (data set) condition 

Data set not open or device marked unusable 

when I/O was requested 

DSCB was not OPEN; DDB address = 



V_>" 



Note: The actual number 
second word of the TCB. 



of records transferred is in the 
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Return Codes 



Tape Return Codes 






Return 
Code 



-1 
1 
2 

5 
6 
10 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
76 



Cond i t i on 



Successful completion 

Exception but no status 

Error reading STATUS 

Error issuing STATUS READ 

Unrecoverable I/O error 

Error issuing I/O command 

Tape mark (EOD) 

Device in use or offline 

Wrong length record 

Not ready 

File protect 

EOT 

Load po i nt 

Uncorrected I/O error 

Attempt WRITE to unexpired data set 

Invalid b Iks i ze 

Data set not open 

Incorrect device type 

Incorrect request type on close request 

Block count error during close 

E0V1 label encountered during close 

DSN not found 



o 



Note: The actual number 
second word of the TCB. 



of records transferred is in the 
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4~ *\ 



EXIO Return Codes (Part 1 of 2) 



I/O Instruction Return Codes (word of TCB; 
word 1 of TCB contains supervisor instruction 
address ) 



Return 


Code 


-1 


1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


16 



Cond i t i on 



Command accepted 

Device not attached 

Busy 

Busy after reset 

Command reject 

Intervention required 

Interface data check 

Cont ro Her busy 

Channel command not allowed 

No DDB found 

Too many DCBs chained 

No address specified for residual status 

EXIODEV specified zero bytes for residual 

status 

Broken DCB chain (program error) 

Device already opened 



€ 



-V 
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Return Codes 



EXIO Return Codes (Part 2 of 2) 






Interrupt Condition Codes (bits 4-7 of word 
(If bit is on, bits 8-15=device ID) 



of ECB) 



Return 
Code 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 

12 

13 
14 
15 



Condition 



(PCI) 



and 
and 
and 



PCI 

except i on 
device end 



Control ler end 

Program Controlled Interrupt 

Exception 

De v i ce end 

Attention 

Attent i on 

Attent i on 

Attention 

Not used 

Not used 

SE on and 

SE on and 

status 

SE on and EXIODEV specified no 

res i dua 1 status 

Broken DCB chain 

ECB to be posted not reset 

Error in Start Cycle Steal Status 

(after exception) 



too many DCBs chained 

no address specified for residual 



bytes for 



o 
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Floating-Point Return Codes 



Return 
Code 



Descr i pt i on 



-1 Successful completion 
1 Floating point overflow 
3 Floating point divide check 

(di vide by ' ' ) 
5 Floating point underflow 



- V._>' 



J? 
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Formatted Screen Image Return Codes 

These return codes are issued by the $ I M D A T A > $ I M P E N » and 
$IMPROT subroutines. They are returned in the second word of 
the task control block (TCB) of the calling program. 



$IMDATA — Screen Image Unprotected Fields 



Return 
Code 



Condition 



-1 
9 



Successful completion 
Invalid format in buffer 



$IMOPEN - Formatted Screen Image 



Return 
Code 



-1 
1 
2 
3 

5 
6 
7 
8 



Cond i t i on 



Successful completion 

Disk I/O error 

Invalid data set name 

Data set not found 

Incorrect header or data set length 

Input buffer too small 

Invalid volume name 

No 3101 image available 

Data set name longer than eight-bytes 
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leturn Codes 



! ) 



$IMPROT - Screen Image Protected Fields 



Return 
Code 



Condition 



-1 

9 

10 

11 



Successful completion 

Invalid format in buffer 

FTAB truncated due to insufficient 

buffer s i ze 

Error in building FTAB from 3101 

format; partial FTAB created 



v._y 



C 
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Indexed Access Method Return Codes 

The following identify messages which indicate that the 
indexed data set contains errors: 






Return 


Code 


-1 


-57 


-58 


-80 


-85 


01 


07 


08 


10 


12 


13 


22 


23 


50 


51 


52 



Condition 



54 

55 

56 

60 

61 

62 

70 

80 

85 

90 

100 

101 

110 



Succ 

Data 

Reco 

End 

Reco 

Func 

Link 

Load 

Inva 

Data 

Modu 

Inva 

Get 

Data 

use y 

Data 

Data 

open 

Inva 

proc 

Get 

READ 

Out 

End 

Dupl 

No s 

FCB 

Key 

Key 

READ 

WRIT 

WRIT 



essf 

set 

rd n 

of d 

rd t 

t i on 

mod 

err 

lid 

set 

le n 

lid 

stor 

set 

can 

set 

set 

ed e 

lid 

ess i 

stor 

err 

of s 

of f 

i cat 

pace 

WRIT 

f iel 

save 

err 

E er 

E er 



u 1 c 

has 
ot f 
ata 
o be 

cod 
u le 
or f 
requ 

shu 
ot i 
IACB 
age 

i s 
not 

ope 

i s 
xc lu 
bloc 
ng 
age 
or - 
eque 
i le 
e ke 

for 
E er 
d mo 

are 
or 
ror 
ror 



omp let i on 

been loaded 
ound 

deleted not found 
e not recogn i zed 
in use 
or $IAM 
est 

t down due to error 
ncluded in load module 

address 
error - I ACB 
opened for exclusive 
be opened exclusively 
ned i n load mode 
opened , cannot be 
s i vely 
k size during PROCESS or LOAD 

error - FCB 

FCB 
nee or duplicate key 

y found in PROCESS mode 

i nsert 
ror during DELETE processing 
d i f i ed by user 
a i n use 



- data set closed 
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Return Code; 






LOAD Return Codes 



Return 


Code 


-1 


61 


62 


63 


64 


65 



Condition 



66 

67 

68 
69 
70 
71 
72 

73 

74 
75 
76 

77 
78 

79 

80 
81 

82 



Succes 
The tr 
in the 



In 
In 
No 
In 



an 
an 
spa 
an 



sets p 
equal 
In an 
were p 
A disk 
the lo 
Reser v 
Reser v 
Not en 
Progr a 
Disk o 
d i r ect 
Di sk o 
progra 
Re fere 
Ref ere 
One of 
vo 1 ume 
In va 1 i 
LOAD i 
set(s) 
LOAD i 
par ame 
In val i 
Cross 
not in 
Reques 
of par 



sf ul 
ans i 

sys 
over 
over 
ce a 
over 
asse 
numb 
over 
asse 

or 
ad p 
ed 
ed 

ough 
rn no 
r d i 
or y 
r d i 
m he 
need 
need 

the 



comp 
ent 1 
tern 
lay r 
lay r 
va i 1 a 
lay 1 
d by 
er re 
lay 1 
d to 
d i ske 
roces 



let i on 

oader ($LOADER) is 



not i ncluded 



ma l n 
t fou 
skett 

skett 

ader 

modu 

modu 

data 



equest, no overlay a 
equest, overlay area 
ble for the transien 
oad operation; numbe 
the LOAD instruction 
quired by the overla 
oad operation* no pa 
the loaded program 
tte I/O error occurr 
s 



storage available f 
nd on the specified 
e I/O error while re 



rea ex i sts 
is in use 
t loader 
r of data 
does not 
y program 
rameters 

ed during 



or program 
vol ume 
a d i n g 



e I/O error while reading 

le is not a program 

le is not a data set 

sets not found on referenced 



d data set name 

nstruction did not specify re 

nstruction did not specify re 
ters ( s ) 

d volume label specified 
partition LOAD requested, sup 
eluded at system generation 
ted partition number greater 
titions in the system 



qu i red data 
qu i red 

port 

than number 



Note: If the program being loaded is a sensor I/O program 
and a sensor I/O error is detected, the return code will be a 
sensor I/O return code, not a load return code. 
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Return Codes 



Multiple Terminal Manager Return Codes 

These return codes are returned in a caller-specified variable 
on the SETPAN, FILEIO, FTAB, or SETFMT function. 






CODE 



DESCRIPTION 



501 
500 



-2 

-1 
1 



3 

201 
202 
203 

204 
205 
206 
207 
208 

Other 



Sere 

Term 

no a 

FTAB 

Succ 

Warn 

pane 

unpr 

pos i 

For 

For 

For 

For 

No d 

Data 

Volu 

No f 

all 

I/O 

I/O 

In va 

In va 

SEOD 

leng 

Retu 

Inde 



en d 
i na 1 
ct i o 

cod 
essf 
i ng J 
1 . 

otec 
t i on 
FTAB 
SETP 
FTAB 
SETF 
ata 

set 
me n 
i le 
have 
er r o 
er ro 
lid 
lid 

rec 
th 

rn c 
xed 



ata s 

i s n 
n has 
e not 
u 1 CO 

For 
Input 
ted b 

set 
, no 
AN, u 
, the 
MT, d 
st rea 

not 
ot f o 
tab le 

upda 
r rea 
r wr i 
f unct 
key o 
ord n 

ode f 
Acces 



et not 
ot an I 

been t 

link e 
m p 1 e t i o 
SETPAN, 

buffer 
lanks ( 
to zero 
fields 
npr otec 

FTAB t 
ata str 
m found 
found 
und 

entrie 
tes out 
ding v o 
ting vo 
i on req 
perator 
umber g 



found 

BM 4978/4979 or 3101; 

aken 

dited with application 

n 

this is an uninitilized 

has been set to 
x ' 00 ' ) and cursor 

were found . 

ted data is truncated, 
able is truncated, 
earn is truncated. 



s are available; 

stand i ng 

1 ume d i rectory 

lume d i rectory 

uest 

reater than data set 



rom READ/WRITE or the 
s Method 
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SBIO (Sensor-based I/O) Return Codes 



Return 
Code 



-1 

90 

91 

92 

93 

94 

95 

96 

97 

98 

100 

101 

102 

104 



Cond i t i on 



Successful completion 

Device not attached 

Device busy or in exclusive use 

Busy after reset 

Command reject 

Invalid request 

Interface data check 

Controller busy 

Analog Input over voltage 

Analog Input invalid range 

Analog Input invalid channel 

Invalid count field 

Buffer previously full or empty 

Delayed command reject 



x_-> 



xJ 
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Return Codes 



Terminal I/O Return Codes 

These codes are returned by the PRINTEXT, READTEXT, and 
TERMCTRL instructions. The codes differ depending on the type 
of terminal being accessed. Separate tables show general 
codes* ACCA, General Purpose Interface Bus, Interpr ocessor 
Communications* Series/1 to Series/1, and Virtual Terminal 
return codes . 



Terminal I/O - General 






Return 
Code 



-1 
1 
2 
3 

5 

6 

7 

>10 



Cond i t i on 



Succ 
Dev i 
Syst 
Syst 
Syst 
Dev i 
Inte 
Over 
Code 
mult 
subt 
resu 
( num 
er r o 



essf u 1 
ce not 



em 
em 
em 
ce 



er r o 
er ro 
er ro 
not 
rface d 
run rec 
s great 
i p le er 
ract 10 
It as a 
ber i ng 
r as f o 




Unu 
Sys 
Not 
Sys 
Sto 
Inv 
Sto 
Int 



comp 
atta 
r (b 
r (b 
r ( c 
read 
ata 
e i ve 
er t 
rors 

fro 
n 8- 
f rom 
1 low 
sed 
tern 

use 
tern 
rage 
alid 
rage 
erf a 



le 

ch 

us 

us 

om 

y 

ch 

d 

ha 

m 
bi 
t 
s : 



t i on 

ed 

y condition) 

y after reset ) 

mand re j ect ) 

eck 

n 10 represent possible 

To determine the errors, 
the code and express the 
t binary value. Each bit 
he left) represents an 



error (command reject) 

d 

error (DCB specification check) 

data check 

storage address 

protection check 
ce data check 



Note: For 2741 or PROC devices, subtract 128, not 10; the 
result then contains status word 1 of the ACCA. (Refer to 
Communication Features Description to determine the special 
error condition.) 
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Return Codes 



V_/ 



Terminal I/O - ACCA Return Codes 



Return 
Code 



Condition 



Successful completion 



Bit 



Cond i t i on 



Unused 
1-08 ISB of last operation CI/0 complete) 
9-10 Unused 

11 1 if a write of control operation 
C I/O complete ) 

12 Read operation (I/O complete) 

1 3 Unused 

14-15 Condition code +1 after I/O start or 
condition code after I/O complete 



K^_->*' 



\ J 
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Return Codes 



Terminal I/O - Interprocessor Communications Return Codes 






CODTYPE 



Return 
Code 



EBCD/CRSP 



EBCDIC 



Condition 



-2 IF 

-1 5B 

Handled Not used 

by 

device 

support 



FDFF 
FEFF 
FCFF 



End of transmission (EOT) 

End of record (NL) 

End of subrecord (EOSR) 
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Return Codes 






Terminal I/O - Virtual Terminal Communications Return Codes 



Value 



Transmit 



Rece i ve 



x'8Fnn' NA 
x»8Enn' NA 

-2 NA 

-1 Successful completion 

1 Not attached 

5 Disconnect 

8 Break 



L INE = nn rece i ved 
SKIP=nn received 
Line received (no CR) 
New line received 
Not attached 
D i sconnect 
Break 



LINE = nn (x *8Fnn ' ) : This code is posted for .READTEXT or 
GETVALUE instructions if the other side sent the LINE forms 
control operation; it is transmitted so that the receiving pro- 
gram may reproduce on a real terminal (for printer spooling 
applications for example) the output format intended by the 
sending program. 

SK I P = nn ( x ' 8Enn ' ) : The sending program transmitted S K I P = n n . 

Line Received (—2) : This code indicated that the sending pro- 
gram did not send a new line indication* but that the line was 
transmitted because of execution of a control operation or a 
transition to the read state. This is how* for example* a 
prompt message is usually transmitted with READTEXT or 
GETVALUE. 

New Line Received ( — 1 ) ♦ This code indicates transmission of 
the carriage return at the end of the data. The distinction 
between a new line transmission and a simple line transmission 
is, again, made only to allow preservation of the original out- 
put format . 



v v_=*'' 



Not attached (1): 



operation does 

this code is returned. 



_ If the virtual terminal accessed for the 
not reference another virtual terminal, then 



Disconnect (5) : This code value corresponds to the 'not ready 1 
indication for real terminals; its specific meaning for virtu- 
al terminals is that the program at the other end of the channel 
terminated either through PROGSTOP or operator intervention. 

Break (8) : The break code indicates that the other side of the 
channel is in a state (transmit or receive) which is incompat- 
ible with the attempted operation. If only one end of the chan- 



4" ~X 

\.y 
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Return Codes 



nel is defined with SYNOYES (on the TERMINAL statement), then 
the task on that end will always receive the break code, wheth- 
er or not it attempted the operation first. If both ends are 
defined with SYNC=YES, then the code will be posted to the task 
which last attempted the operation. The break code may thus be 
understood as follows: when reading (READTEXT or GETVALUE), 
the other program has stopped sending and is waiting for input; 
when writing (PRINTEXT or PRINTNUM), the other program is also 
attempting to write. Note that current Event Driven Executive 
programs, or future programs which do not interpret the break 
code, must always communicate through a virtual terminal which 
is defined with SYNC=N0 (the default). 
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TP (Host Communication Facility) Return Codes (Part 1 of 3) 



Return 
Code 



Cond i t i on 



Module 



7 
8 

9 
10 

11 

50 
51 



Successful completion 

Illegal command sequence 

TP I/O error 

TP I/O error on host 

Looping bidding for the line 

Host acknowledgement to Supervisor 

request code was neither ACKO, 

ACK1, WACK, or a NACK 

Retry count exhausted - last 

error was a timeout: the host 

must be down 

Looping while reading data from 

the host 

The host responded with other 

thanan EOT or an ENQ when an 

EOT was expected 

Retry count exhausted - last error 

was a modem interface check 

Retry count exhausted - last error 

was not a timeout* modem check, 

block check, or overrun 

Retry count exhausted - last error 

was a transmit overrun 

I/O error from last I/O in DSWRITE 

I/O error when writing the last 

buffer 



Supervisor 
Super v i sor 
Super visor 
HCFCOMM 
Supervisor 



Supervisor 

Super v i sor 
Super v i sor 

Supervisor 
Super v i sor 

Super v i sor 

DSCLOSE 
DSCLOSE 



100 
101 
102 



Length of DSNAME is zero 
Length of DSNAME exceeds 52 
Invalid length specified for 



I/O 



HCFCOMM 
HCFCOMM 
HCFINIT 



\.S 
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Return Code: 



T? (Host Communication Facility) Return Codes (Part 2 of 3) 



jf*\ 



Return 
Code 



Condition 



Modu le 



200 

201 
202 

203 

204 
205 

206 

207 
208 
209 
211 
212 
213 
214 
216 

217 

218 
219 
220 

221 
222 



Data 

for 

In va 

Data 

Data 

this 

Data 

Data 

volu 

Data 

de v i 

Volu 

De v i 

Data 

Reco 

Inva 

Inva 

Data 

Data 

and 

Data 

and 

Er ro 

The 

An I 

dire 

Inva 

Insu 

ava i 



set 

cont 

lid 

set 

set 

tas 

set 

set 

mes 

set 
ce 

me n 

ce n 

set 

rd f 

lid 

lid 

set 

set 

no m 

set 

a me 

r du 

spec 

/0 e 

ctor 

lid 

f f ic 

labl 



not on volume specified 
roller 
member name specification 

in use by another job 

already allocated to 
k 

i s not cata loged 

resides on multiple 

is not on a direct access 

ot mounted (archived) 
ot online 

does not exist 
ormat is not supported 
logical record length 
b lock s i ze 

has no extents 

organization is partitioned 
ember name was specified 

organization is sequential 
mber name was specified 
ring OS/ OPEN 

ified member was not found 
rror occurred during a 
y search 

data set organization 
ient I/O buffer space 
e 



HCFINIT 

DSOPEN 
DSOPEN 

DSOPEN 
DSOPEN 

DSOPEN 

DSOPEN 
DSOPEN 
DSOPEN 
DSOPEN 
DSOPEN 
DSOPEN 
DSOPEN 
DSOPEN 

DSOPEN 

DSOPEN 
DSOPEN 
DSOPEN 

DSOPEN 
DSOPEN 

DSOPEN 



300 End of an input data set 

301 I/O error during an OS/ READ 

302 Input data set is not open 

303 A previous error has occurred 



DSREAD 
DSREAD 
DSREAD 
DSREAD 
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TP (Host Communication Facility) Return Codes (Part 3 of 3) 



Return 
Code 



Cond i t i on 



Modu le 



400 End of an output data set 

401 I/O error during an OS/ WRITE 

402 Output data set is not open 

403 A previous error has occurred 

404 Partitioned data set is full 



DSWRITE 
DSWRITE 
DSWRITE 
DSWRITE 
DSCLOSE 



700 Index, key, and status record added SET 

701 Index exists, key and status added SET 

702 Index and key exist, status replaced SET 

703 Error - Index full SET 

704 Error - Data set full SET 
710 I/O Error SET 



800 Index and key exist 

801 Index does not exist 

802 Key does not exist 
810 I/O error 



FETCH 
FETCH 
FETCH 
FETCH 



900 Index and/or key released 

901 Index does not exist 

902 Key does not exist 
910 I/O error 



RELEASE 
RELEASE 
RELEASE 
RELEASE 



lxxx An error occurred in a subordinate 
module during SUBMIT. 'xxx' is 
the code returned by that module. 



S7SUBMIT 
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Post Codes 



EVENT DRIVEN LANGUAGE AND FUNCTION POST CODES 



The Event Driven language and function post codes are returned 
to the first word of the event control block (ECB) (unless 
stated otherwise) to signal the occurrence of an event. 
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Post Codes 



/if ^ 



Tape Post Codes 

If you initialize a tape by loading STAPEIT from a program or by 
invoking $JOBUTIL and passing the above parameters, the fol- 
lowing post codes are returned to the event control block (ECB) 
of the calling program. 



Post Code 



Cond i t i on 



-1 
RC 
101 
102 
103 
104 



Function successful 

Any tape I/O return code 

TAPEID not found 

Device no offline 

Unexpired data set on tape 

Cannot initialize BLP tapes 



V,,> 
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